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Preface 


“Who Is Kermit and Why Is He in My Computer?” asked a recent headline [52]. 1 Kermit 
is not a “he” at all, but rather an inanimate, genderless, yet personable and friendly com¬ 
puter software package that lets just about any two computers in the world communicate 
effectively with each other, no matter how they may differ in size, appearance, location, 
power, architecture, manufacture, or nationality. 

This book describes the Kermit program, C-Kermit, for UNIX computer systems, Digital 
Equipment Corporation VMS and Open VMS systems, Data General AOS/VS systems, 
PCs with OS/2, the Commodore Amiga, the Atari ST, and computers with the OS-9 real¬ 
time operating system. The UNIX version of C-Kermit runs on most known modem im¬ 
plementations of UNIX (see page 13) and on computers ranging from PCs to large 
mainframes and supercomputers. 

C-Kermit software gives you terminal connection, error-free file transfer and manage¬ 
ment, comprehensive support for national and international character sets, and a wide 
variety of communication methods including direct or dialed serial connections and (in 
some versions) TCP/IP or other kinds of network connections. You can use C-Kermit be¬ 
tween two computers, or to access dialup information services like CompuServe or MCI 
Mail as well as subscriber-based public data networks like SprintNet and TYMNET, and 
even the worldwide TCP/IP Internet. 


'Numbers in brackets refer to entries in the the bibliography on page 491. 
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With C-Kermit’s powerful script programming language, you can have Kermit perform 
routine or time-consuming tasks for you automatically: let the computers handle the 
drudgery while you’re attending to other matters. 

C-Kermit transfers text and binary files efficiently and correctly. The Kermit file transfer 
protocol takes care of synchronization, error detection and correction, file format and 
character set conversion, and myriad details you should never have to worry about. The 
Kermit protocol was designed to work in hostile communication environments where 
other protocols fail. 

The Kermit file transfer protocol was designed in 1981 at the Columbia University Center 
for Computing Activities (CUCCA), which has been “Kermit Headquarters” ever since. 
The Kermit protocol is simple, robust, adaptable to almost any style of communication 
and any computer architecture, and its specification is open and public [18]. Source code 
availability gives users confidence in this age of viruses and worms and it allows users to 
fix bugs, add features, and adapt the software to new computers or local conditions. 

Kermit software is produced by dedicated volunteer programmers in all parts of the world, 
whose efforts are coordinated from Columbia, where a definitive collection of all Kermit 
software is maintained, supporting hundreds of different computers and operating systems. 
Kermit is the low-cost, high-quality alternative to commercial communication software. 

Acknowledgments 

C-Kermit was written by Frank da Cruz of Columbia University with contributions from 
hundreds of other developers and testers. The following are just a few of the contributors, 
all of whom have our deepest thanks (U = University, locations in the USA unless other¬ 
wise indicated): 

Chris Adie (Edinburgh U, Scotland); Robert Adsett (U of Waterloo, Canada); Larry Afrin 
(Clemson U); Greg Andrews (Telebit Corp); Barry Archer (U of Missouri); Bengt An- 
dersson (ABC-Klubben, Sweden); Robert Andersson (International Systems A/S, Oslo, 
Norway); Chris Armstrong (Brookhaven National Laboratory); William Bader (Software 
Consulting Services, Nazareth, PA); Fuat Baran (Columbia U); Stan Barber (Rice U); Jim 
Barbour (U of Colorado); Donn Baumgartner (Dell Computer Corp); Nelson Beebe (U of 
Utah); Karl Berry (UMB); Dean W Bettinger (State U of New York); Gary Bilkus; Marc 
Boucher (U of Montreal, Canada); Charles Brooks (EDN); Bob Brown; Mike Brown (Pur¬ 
due U); Rodney Brown (COCAM, Australia); Jack Bryans (California State U at Long 
Beach); Mark Buda (DEC); Fernando Cabral (Padrao IX, Brasilia, Brazil); Bjorn Carlsson 
(Stockholm U Computer Centre QZ, Sweden); Bill Catchings (formerly of Columbia U); 
Bob Cattani (formerly of Columbia U); Davide Cervone (Rochester U, NY); Seth Chaik- 
lin (Denmark); John Chandler (Harvard U/Smithsonian Astronomical Observatory, 


xvi Preface 




Cambridge, MA); John L Chmielewski (AT&T, Lisle, IL); Howard Chu (U of Michigan); 
Bill Coalson (McDonnell Douglas); Bertie Coopersmith (London, England); Chet Creider 
(U of Western Ontario, Canada); Alan Crosswell (Columbia U); Jeff Damens (formerly of 
Columbia U); Mark Davies (Bath U, England); S. Dezawa (Fujifilm, Japan); Joe R. Doup- 
nik (Utah State U); Frank Dreano (US Navy); John Dunlap (U of Washington); Jean 
Dutertre (DEC France); David Dyck (John Fluke Mfg Co.); Stefaan Eeckels (Statistical 
Office of the European Community, CEC, Luxembourg); Paul Eggert (Twin Sun, Inc.); 
Bemie Eiben (DEC); Kristoffer Eriksson (Peridot Konsult AB, Oerebro, Sweden); John 
Evans (IRS, Kansas City); Glenn Everhart (RCA Labs); Charlie Finan (Cray Research, 
Darien, CT); Herm Fischer (Encino, CA); Carl Fongheiser (CWRU); Marcello Frutig 
(Catholic U, Sao Paulo, Brazil); Hirofumi Fujii (Japan National Laboratory for High 
Energy Physics, Tokyo); Chuck Fuller (Westinghouse); Andy Fyfe (Caltech); Hunter 
Goatley (Western Kentucky U); John Gilmore (UC Berkeley); German Goldszmidt 
(IBM); Alistair Gorman (New Zealand); Richard Gration (Australian Defence Force 
Academy); Chris Green (Essex U, England); Alan Grieg (Dundee Tech, Scotland); Yekta 
Gursel (MIT); Jim Guyton (Rand Corp); Vesa Gynther (Finland); Michael Haertel; 
Marion Hakanson; John Hamilton (Iowa State U); Steen Hammerum (U of Kpbnhavn, 
Denmark); Simon Hania (Netherlands); Stan Hanks (Rice U); Ken Harrenstein (SRI); 
Eugenia Harris (Data General); David Harrison (Kingston Warren Corporation); James 
Harvey (Indiana/Purdue U); Rob Healey; Chuck Hedrick (Rutgers U); Ron Heiby 
(Motorola Computer Group); Steve Hemminger (Tektronix); Christian Hemsing 
(Rheinisch-Westfalisch Technische Hochschule, Aachen, Germany); Andrew Herbert 
(Monash U, Australia); Mike Hickey (ITI); R.E. Hill; Bill Homer (Cray Research); Randy 
Huntziger (US National Library of Medicine); Larry Jacobs (Transarc); Steve Jenkins 
(Lancaster U, England); Dave Johnson (Gradient Technologies); Mark Johnson (Apple 
Computer); Eric Jones (AT&T); Luke Jones (AT&T); Peter Jones (U of Quebec, 
Montreal, Canada); Phil Julian (SAS Institute); Peter Kabal (U of Quebec); Mic 
Kaczmarczik (U of Texas at Austin); Sergey Kartashoff (Institute of Precise Mechanics & 
Computer Equipment, Moscow); Howie Kaye (Columbia U); Rob Kedoin (Linotype Co, 
Hauppauge, NY); Mark Kennedy (IBM); Terry Kennedy (St Peter’s College, Jersey City, 
NJ); Douglas Kingston; John Klensin (MIT); Tom Kloos (Sequent Computer Systems); 
Jim Knutson (U of Texas at Austin); John Kohl; David Kricker (Encore Computer); 
Thomas Krueger (U of Wisconsin at Milwaukee); Bo Kullmar (Central Bank of Sweden, 
Kista, and ABC-Klubben, Stockholm); R. Brad Kummer (AT&T Bell Labs, Atlanta, GA); 
John Kunze (UC Berkeley); Russell Lang (Monash U, Australia); Bob Larson (USC); Bert 
Laverman (Groningen U, Netherlands); Steve Layton; David Lawyer (UC Irvine); David 
LeVine (National Semiconductor Corp.); S.O. Lidie (Lehigh U); Tor Lillqvist (Helsinki 
U, Finland); Benny Lofgren (DIAB, Sweden); Dean Long; Kevin Lowey (U of Sas¬ 
katchewan, Canada); Andy Lowry (Columbia U); David MacKenzie (Environmental 
Defense Fund, U of Maryland); John Mackin (U of Sidney, Australia); Martin Maclaren 
(Bath U, England); Chris Maio (formerly of Columbia U); Fulvio Marino (Olivetti, Ivrea, 
Italy); Peter Mauzey (AT&T); Tye McQueen (Utah State U); Ted Medin (NOSC); Ajay 


Acknowledgments xvii 



Mehta (DEC); Hellmuth Michaelis (Hanseatischer Computerservice GmbH, Hamburg, 
Germany); Leslie Mikesell (American Farm Bureau); Gary Mills (U of Manitoba, 
Canada); Martin Minow (DEC); Pawan Misra (Bellcore); Ken Mizialko (IBM, Manassas, 
VA); Ray Moody (Purdue U); Bruce J Moore; Steve Morley (Convex); Peter Mossel 
(Columbia U); Tony Movshon (NYU); Lou Muccioli (Swanson Analysis Systems); Dan 
Muiphy; Gary Mussar (Bell Northern Research); John Nall (Florida State U); Jack Nelson 
(U of Pittsburgh); Jim Noble (PRC, Inc.); Ian O’Brien (Bath U, England); John Owens; 
Michael Pins (Iowa Computer Aided Engineering Network); Andre Pirard (U of Liege, 
Belgium); Paul Placeway (Ohio State U); Piet Plomp (Groningen U, Netherlands); Ken 
Poulton (HP Labs); Manfred Prange (Oakland U); Christopher Pratt (APV Baker, UK); 
Frank Prindle (NADC); Tony Querubin (U of Hawaii); Phil Race (ICL, Manchester, 
England); Anton Rang; Scott Ribe; Alan Robiette (Oxford U, England); Michel Robitaille 
(U of Montreal, Canada); Kai Uwe Rommel (Technische Universitat Miinchen, Ger¬ 
many); Larry Rosenman (Irving, TX); Jay Rouman (U of Michigan); Jack Rouse (SAS In¬ 
stitute); Stew Rubenstein (Harvard U); Bill Schilit (Columbia U); Michael Schmidt (U of 
Paderbom, Germany); Eric Schnoebelen (Convex); Benn Schreiber (DEC); Dan 
Schullman (DEC); John Schultz (3M); Steven Schultz (Contel); APPP Scorer (Leeds 
Polytechnic, England); Gordon Scott (Micro Focus, Newbury, England); Gisbert W. Selke 
(Wissenschaftliches Institut der Ortskrankenkassen, Bonn, Germany); David Sizeland (U 
of London Medical School, England); Fridrik Skulason (Iceland); Dave Slate; Bradley 
Smith (UCLA); Richard Smith (California State U); Ryan Stanisfer (UNT); Bertil 
Stenstrom (Stockholm U Computer Centre QZ, Sweden); James Sturdevant (cap GEMENI 
AMERICA, Minneapolis, MN, and Medtronic, Inc., Fridley, MN); Peter Svanberg (Kungl. 
Tekniska Hogskolan, Sweden); James Swenson (Accu-Weather, Inc., State College, PA); 
Chris Sylvain (U of Maryland); Andy Tanenbaum (Vrije U, Amsterdam, Netherlands); 
Tim Theisen (U of Wisconsin); Lee Tibbert (DEC); Markku Toijala (Helsinki U of Tech¬ 
nology, Finland); Rick Troxel (US National Institutes of Health); Warren Tucker (Tridom 
Corp, Mountain Park, GA); Dave Tweten (NASA); G. Uddeborg (Sweden); Walter Un¬ 
derwood (Ford Aerospace); Pieter Van Der Linden (Centre Mondial, Paris, France); Ge 
van Geldorp (Netherlands); Fred van Kempen (MINIX User Group, Voorhout, Nether¬ 
lands); Wayne Van Pelt (General Electric Corporate Research and Development); Mark 
Vasoll (Oklahoma State U); Konstantin Vinogradov (ICSTI, Moscow, Russia); Paul Vixie 
(DEC); Eduard Vopica (Prague School of Economics, Czechoslovakia); Dimitri Vulis 
(City U of New York); Roger Wallace (Raytheon); Stephen Walton (California State U at 
Northridge); Jamie Watson (Adasoft, Switzerland); Rick Watson (U of Texas); Robert 
Weiner (Programming Plus, New York City); Lauren Weinstein (Vortex Technology); 
David Wexelblat (AT&T Bell Labs); Bill Whitney (DEC); Joachim Wiesel (U of 
Karlsruhe, Germany); Lon Willett (U of Utah); Michael Williams (UCLA); Nate Williams 
(U of Montana); David Wilson; Patrick Wolfe (Kuck & Associates, Inc.); Gregg 
Wonderly (Oklahoma State U); Farrell Woods (Concurrent); Dave Woolley (CAP Com¬ 
munication Systems, London, England); Jack Woolley (SCT Corp); Frank Wortner; Ken 
Yap (formerly of U of Rochester, NY); John Zeeff (Ann Arbor, MI). 


xviii Preface 



Of those listed above, special thanks are due to Bill Catchings for his work on the basic 
design of the Kermit protocol and for its first two software implementations; to Chris 
Maio and Bob Cattani for version 1 of UNIX Kermit (the predecessor of C-Kermit), circa 
1983; to Bill Catchings and Jeff Damens for version 3 (1984, there was no version 2); and 
to Herm Fischer and Dan Schullman for large contributions to version 4, the first release 
of C-Kermit in its present interactive form (1985). 

Version 5, too, was a cooperative effort. Kristoffer Eriksson, Bo Kullmar, Warren 
Tucker, and Peter Mauzey comprised the “modem committee,” which worked long and 
hard to rationalize C-Kermit’s treatment of modem signals in the many and varied UNIX 
environments. Kristoffer deserves a special Archaeology Achievement Award for a 
detailed study and unraveling of many years’ accretion of incomprehensible magic in the 
infamous “ckutio” module (a collection of supposedly simple functions that gives the em¬ 
phatic lie to all claims that UNIX is a “portable operating system”). 

Before we leave the special awards department, this year’s Life Achievement Award goes 
to Terry Kennedy for endless and unenviable hours filling in the particulars for the in¬ 
finitely complex VMS file system, and for helping out in numerous other ways. And 
thanks to the others who helped with VMS, especially Lee Tibbert, Mark Buda, William 
Bader, Alan Robiette, Hunter Goatley, and James Harvey. 

Chris Adie adapted C-Kermit version 4 to OS/2 in 1988, and Kai Uwe Rommel adapted 
the OS/2 support to version 5A and to OS/2 2.00—no small task!—and contributed many 
other valuable ideas and insights. 

The Data General AOS/VS support was originally done many years ago by Phil Julian at 
the SAS Institute for C-Kermit 4D. Special thanks to Data General Corporation for spon¬ 
soring the development of AOS/VS support in C-Kermit 5A as well as new developments 
in MS-DOS Kermit; to Eugenia Harris of Data General for doing the AOS/VS-specific 
programming as well as supplying lots of descriptive material, not to mention numerous 
good ideas; and to Mike Normile of DG, who supplied equipment, documentation, sug¬ 
gestions, and all-around support and encouragement. 

Steve Walton took care of the Commodore Amiga (with help from Larry Rosenman), 
Bruce Moore is primarily responsible for Atari ST adaptation, and Christian Hemsing for 
OS-9 (with earlier work by Bob Larson). 

Ken Yap contributed the first bit of TCP/IP sockets code for the Berkeley UNIX version. 
Marcello Frutig and Stefaan Eeckels supplied the X.25 support code. Chuck Hedrick 
found and fixed many bugs in the UNIX version and also gave lots of help along the way. 


Acknowledgments xix 



Thanks to the indefatigable and omniscient Professor Joe Doupnik (author of MS-DOS 
Kermit), who worked closely with the authors on the design of the sliding window al¬ 
gorithms, the script programming language, and the international character set support 
during the joint development effort for MS-DOS Kermit 3.0 and C-Kermit 5A (and in his 
spare time, Joe lent a hand with the AT&T 7300 UNIX PC and System V R4 versions of 
C-Kermit). 

Our grateful acknowledgments to the specialists who contributed to the proposal for ex¬ 
tending the Kermit protocol to accommodate international character sets: John Chandler 
(Harvard/Smithsonian Center for Astrophysics), Joe Doupnik (Utah State University), 
Hirofumi Fujii (Japan National Laboratory for High Energy Physics, Tokyo), John Klen- 
sin (Massachusetts Institute of Technology and chair of the ACM Standards Committee), 
Ken-ichiro Murakami (Nippon Telephone and Telegraph Research Labs, Tokyo), 
Vladimir Novikov (VNIIPAS, Moscow, Russia), Andre Pirard (University of Liege, Bel¬ 
gium), Gisbert W. Selke (Wissenschaftliches Institut der Ortskrankenkassen, Bonn, Ger¬ 
many), Fridrik Skulason (University of Iceland, Reykjavik), Johan van Wingen (Leiden, 
Netherlands, member of numerous ISO committees), and Konstantin Vinogradov (ICSTI, 
Moscow, Russia). And thanks to Valdemar Gunnarson for the Icelandic translation on 
page 196. 

Thanks too to those who supplied specific information about the character sets used in the 
former Soviet Union today: Konstantin Vinogradov of ICSTI, Michael Yaroslavtsev and 
Sergey Kartashov of the Institute of Precise Mechanics and Computer Equipment of the 
(former) USSR Academy of Sciences, and Dimitri Vulis of D&M Consulting Services 
Inc. in New York City. And to Jay Sekora at Princeton University for the PostScript 
Cyrillic font used in this book. 

Hirofumi Fujii supplied the algorithms and much of the code for conversion among the 
various Japanese Kanji character sets. 

And thanks to the programmers who have been adding this protocol extension to other 
Kermit programs so C-Kermit can talk to them: John Chandler (Kermit-370), Joe Doupnik 
(MS-DOS Kermit), the “Kermit gang” at ICSTI, and Hirofumi Fujii (Kanji support in 
MS-DOS Kermit and C-Kermit). 

Special thanks to Drs. Juri Gornostaev and A. Butrimenko of ICSTI for sponsoring the 
First International Kermit Conference in Moscow in May 1989, where the international 
character set extension was first discussed in public. 

And thanks to the hundreds of others who tested C-Kermit 5A on countless hardware and 
software platforms and contributed bug reports, fixes, new features, and suggestions over 
its three-year development period. 


xx Preface 



Also thanks to the “Kermites” in the Kermit Factory, who do such a fine job at technical 
support, filling software orders, running our machines, and generally keeping the Kermit 
Distribution operation running smoothly: Max Evarts, Andy Newcomb, and the genera¬ 
tions who came before, especially Bob Tschudi, Peter Howard, Lucy Lee, and Ken Suh. 

Special thanks to those who reviewed the first draft manuscript of this book: Donn Baum¬ 
gartner of Dell Computer, Max Evarts of Columbia University, Terry Kennedy of Saint 
Peters College, Kai Uwe Rommel of the Technical University of Munich, Benn Schreiber 
of Digital Equipment Corporation, Warren Tucker of Tridom Corporation, Bruce J. 
Moore, and particularly to Eugenia Harris of Data General Corporation and John Klensin 
of MIT for their detailed comments and suggestions. 

Many thanks to our management and colleagues at Columbia University for their support, 
especially Va$e Kundak£i, Deputy Vice President for Academic Information Systems, and 
Elaine Sloan, Vice President for Information Services and University Librarian; to Bruce 
Gilchrist and Howard Eskin, former directors of our organization; and to Lee Lidofsky, a 
Great Teacher, for an initial push in the right direction. 

Finally, thanks to those who helped put this book together—the staff at Digital Press: John 
Osborn, Chase Duffy, Monica Broadnax, Will Buddenhagen, Beth French, Cindyrose 
Newfell, Jan Svendsen; and to Laura Fillmore and the staff of Editorial, Inc.: Steve Ack¬ 
erman, the illustrator; Ann Hall, the copy editor; MaryEllen Oliver, the proofreader. 

Frank da Cruz and Christine M. Gianone 
New York City, December 1992 

fdc@columbia.edu, cmg@columbia.edu 
KERMIT@CUVMA.BITNET 


Acknowledgments xxi 



Chapter 1 


Introduction 


An ever-increasing amount of communication is electronic and digital: computers talking 
to computers—directly, over the telephone system, through networks. When you want 
two computers to communicate it is usually for one of two reasons: to interact directly 
with the remote computer or to transfer data between the two computers. Kermit software 
gives you both these capabilities, and more. 

C-Kermit is a Kermit program written in the C language. It is portable among many dif¬ 
ferent kinds of computers and operating systems, including UNIX, VMS and Open VMS, 
AOS/VS, OS/2, OS-9, the Commodore Amiga, and the Atari ST, where C-Kermit’s ser¬ 
vices include modem dialing, terminal connection, file transfer, file management, un¬ 
attended automated operation, and in many cases, network capability too. 

Why Kermit? 

• Kermit software is universal. Kermit programs have been written for hundreds of dif¬ 
ferent kinds of computers (see page 9). Chances are you’ll find it already on any com¬ 
puter you use. If not, it is most likely available. And when your computer has Kermit 
software but the other computer does not, you can still use your own Kermit program 
for terminal emulation and “unguarded” file transfer. 

• Kermit software communicates not only over dialup connections, but also over 
high-speed direct connections, local area networks, and wide area networks, so you 
can use the same software for most kinds of connections. 


1 




The Other Computer 
(REMOTE) 



YOU ARE NOT HERE 


Your Computer 
(LOCAL) 



Figure 1-1 Remote and Local Computers 


• Kermit software is flexible. It is adaptable to the styles and formats of the many com¬ 
puter manufacturers and communication service providers. 

• Kermit software is easy to use. The commands are ordinary words, rather than cryptic 
codes. Menus are available upon demand. 

• Kermit software is powerful. Procedures can be automated using a script program¬ 
ming language composed of ordinary Kermit commands. 

• Kermit file transfer is rugged and efficient. It works in hostile or restrictive communi¬ 
cation environments where other protocols fail. 

• Kermit file transfer is international. It can transfer text in many languages and charac¬ 
ter sets without scrambling the special characters. 

• Kermit software is accessible. Because it has a character-mode user interface, it is 
compatible with speech, Braille, and other enabling devices. 

• Source code is available. You can make improvements, fix bugs, assure yourself that 
there is no virus infestation, and adapt the code to new platforms. 

One software package for practically all your communication needs: no switching from 

package to package to communicate with different kinds of computers or services or to 
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The Other Computer 
(REMOTE) 



C-Kermit> set speed 2400 
C-Kennit> dia 1 7654321 

Figure 1-2 Connecting the Local and Remote Computers 


use different communication methods; no need to support multiple packages. And as an 
added benefit, most Kermit software programs have the same basic set of commands and 
procedures—once you’ve learned one Kermit program, you’ve learned them all. 

How Kermit Works 


Picture two computers, like the ones in Figure 1-1. You are using one of them directly: it 
is a PC or workstation on your desk, or it is a timesharing system connected to a terminal 
(or terminal emulator) on your desk. Let’s call this the local computer. You want to con¬ 
nect your local computer to a more distant, remote computer or service and transfer data. 

IMPORTANT: Remember the terms local and remote. They are used through¬ 
out this book. The local computer is the one you are making the connection 
from. The remote computer is the one you are making the connection to. 

Let’s say you are connecting the two computers by telephone. First be sure that both com¬ 
puters have a modem. Then you must know the name of the device that the modem is 
connected to on your local computer, a transmission speed that is common to both the lo¬ 
cal and remote modems, and the telephone number for the remote modem. Let’s look at 
Figure 1-2. We start the local Kermit program simply by typing the word kermit. 
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IMPORTANT: In the figures, and in all examples used in this book, the text 
you type is underlined . When you are typing commands to your operating sys¬ 
tem or to a Kermit program, you must terminate them by pressing the Return or 
Enter key at the point where the underlining ends (unless otherwise indicated). 

When the local Kermit’s prompt appears, we give it commands to tell it the modem type 
and the communication device name and speed, and then we tell it to dial the other 
computer’s phone number. When the other computer answers the phone, communication 
can begin. Give your local Kermit the connect command and suddenly you are talking 
to the remote computer just as if you were using it directly. Identify yourself (log in) as 
shown in Figure 1-3 and carry on a dialog to conduct your business. Eventually you 
might decide that you want to move some data (a file) from one computer to the other. 

To transfer a file, both computers must be running Kermit programs. Your local computer 
already is. Simply type “kermit” on the remote computer to start the remote Kermit 
program. 2 Now you must tell each Kermit program what to do: one of them must be told 
to send a file of a certain name and the other must be told to receive the file. The rule is: 
(1) Tell the remote computer what to do first (SEND or RECEIVE), then (2) get back to the 
local computer and tell it the opposite (receive or send), as shown in Figure 1-4. 


2 If there is no Kermit software on the remote computer, another file transfer method is also available. 
See Chapter 10. 
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How do you get back to the local computer? After you CONNECT to the remote computer, 
the local Kermit sends all the characters you type straight to the remote computer, without 
paying any attention to them itself. But one character is special during a CONNECT ses¬ 
sion. C-Kermit notices when you type this special character (usually a control character 
such as Ctrl-Backslash) and interprets the next character that you type as a command, for 
example the letter “C” to Come back to the prompt. This two-character sequence is 
shown in the figure as Ctrl-\c, and entering it is referred to as “escaping back.” 

Here is an example of the basic procedure, in which you are transferring the file 
oofa.txt from the remote computer to the local one. Your local computer is a UNIX 
workstation with C-Kermit and the remote computer is running Open VMS, also with 
C-Kermit (both computers need not be running C-Kermit, but we assume that at least one 
of them is). 

1. Start Kermit on your local computer: 

$ kermit 

C-Kermit 5A(188), 23 Nov 92, SunOS 4.1 

Type ? or HELP for help 

C-Kermit> 

2. Tell it the modem type and the name and speed of the communication device: 

C-Kermit> set modem hayes 
C-Kermit> set line /dev/cua 
C-Kermit> set speed 2400 
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3. Have it dial the telephone number of the remote computer: 

C-Kermit> dial 7654321 

4. Enter terminal mode: 

C-Kermit>connect 

5. Log in to the remote computer and start Kermit there: 

Welcome to the Remote Computer 
Username: myname 

Password: _ 

$ 

$ kermit 

C-Kermit 5A(188), 23 Nov 92, OpenVMS VAX 

Type ? or HELP for help 

C-Kermit> 

6. Tell the remote Kermit program to send the file: 

C-Kermit >send oofa.txt 

Return to your local Kermit and give a RECEIVE command. 
KERMIT READY TO SEND... 

7. Enter the key sequence to escape back from terminal mode to your local Kermit 
program and tell it to receive the file: 

Ctrl-\c 

C-Kermit>receive 


Now the two Kermit programs begin talking to each other using specially formatted mes¬ 
sages called packets, which contain not only data from your files, but also control infor¬ 
mation, such as “here is the file name,” “here is the first piece of data from the file,” 
“here is the second piece,” “that was the last piece,” “please send the second piece 
again,” and so on. The data in each packet is encoded to contain only printable characters 
to ensure that it will pass through sensitive communication devices. All packets include 
error checking and sequencing information to prevent your data from being lost, dupli¬ 
cated, or damaged. 

This is the basic scenario for file transfer. There are many variations: you can send files in 
the other direction (by exchanging the SEND and RECEIVE commands), you can transfer a 
group of files in a single operation, you can operate the remote Kermit as a fully 
protocol-driven file server, and you can automate the process to any desired degree using 
C-Kermif s script programming language. The details of the Kermit file transfer protocol 
are given in a separate book [18, Chapters 8-12]. 
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Capabilities of C-Kermit 

C-Kermit is among the most advanced and powerful of all the Kermit programs. Here is a 
brief list of some of its features. The terminology will be explained more fully as we go 
along. 

• Support for nearly all known varieties of UNIX (see p. 13), for Digital Equipment 
Corporation VMS and Open VMS, IBM OS/2, Data General Corporation AOS/VS, 
Microware OS-9, Commodore AmigaDOS, and Atari ST GEMDOS. 

• Error-correcting, efficient file transfer using the Kermit protocol. Text or binary files 
may be transferred singly or in groups. 

• Operation at a wide range of speeds using standard serial communication ports. 

• Support for network connections including TCP/IP and X.25 on selected UNIX, VMS, 
Open VMS, AOS/VS, and other configurations. 

• Communication settings that can be matched to virtually any other computer. 

• Automatic dialing with a wide variety of modems. 

• Terminal connection to remote computers, including character set translation, key 
mapping, keyboard macros, and session logging capabilities. 

• A simple, consistent, and intuitive command language with built-in help, in most ways 
compatible with MS-DOS Kermit. 

• Command and initialization files. 

• Command macros and a powerful script programming language. 

• Logging, security, and debugging features. 

• Kermit protocol capabilities including long packets, sliding windows, international 
text character-set conversion, checksum and CRC error correction, the ability to trans¬ 
fer 8-bit data through a 7-bit communications channel using both single and locking 
shifts, automatic parity detection, transmission of file attributes, server mode, 
run-length data compression, file management functions, file transfer interruption, and 
more. C-Kermit also has the ability to transmit and receive files without error check¬ 
ing when the other computer doesn’t have a Kermit program. 

Thus, C-Kermit combines all the features you need to communicate with other computers 
or services interactively (or automatically in your absence) and to transfer files with just 
about any other kind of computer. 
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Capabilities of Popular Kermit Programs 

C-Kermit’s capabilities are compared with other popular Kermit programs in Table 1-1. 
C-K is C-Kermit, MS-K is MS-DOS Kermit, Mac-K is Macintosh Kermit, K-370 is IBM 
Mainframe Kermit, K-ll is PDP-11 Kermit, K-80 is CP/M-80 Kermit, and K-65 is Apple 
II Kermit. This table represents the situation as of this writing, and naturally is not 
guaranteed to hold true forever. 


Table 1-1 Kermit Software Features 


Feature 

C-K 

MS-K 

Mac-K 

K-370 

K-ll 

K-80 

K-65 

Local operation 

Yes 

Yes 

Yes 

No 

Yes 

Yes 

Yes 

Remote operation 

Yes 

Yes 

No 

Yes 

Yes 

No 

No 

Network support 

Yes 

Yes 

No 

No 

No 

No 

No 

Automatic feature negotiation 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

International text 

Yes 

Yes 

Yes 

Yes 

No 

No 

No 

File transfer interruption 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Filename collision actions 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Single shifts 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Locking shifts 

Yes 

Yes 

Yes 

Yes 

No 

No 

No 

Run-length compression 

Yes 

Yes 

Yes 

Yes 

Yes 

No 

No 

Alternate block checks 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

No 

Automatic parity detection 

Yes 

Yes 

No 

N/A 

No 

No 

No 

Dynamic packet length 

Yes 

No 

Yes 

Yes 

No 

No 

No 

Key mapping 

Yes 

Yes 

Yes 

N/A 

No 

No 

No 

Support for dialout modems 

Yes 

Yes 

Yes 

N/A 

Yes 

No 

Yes 

Act as server 

Yes 

Yes 

Yes 

Yes 

Yes 

No 

No 

Talk to server 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Advanced server functions 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Security for server 

Yes 

Yes 

Yes 

No 

No 

N/A 

N/A 

Local file management 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Command/Init files 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Long packets 

Yes 

Yes 

Yes 

Yes 

Yes 

No 

No 

Sliding windows 

Yes 

Yes 

Yes 

N/A 

No 

No 

No 

Attribute packets 

Yes 

Yes 

Yes 

Yes 

Yes 

No 

No 

Command macros 

Yes 

Yes 

Yes 

No 

No 

No 

No 

Script programming language 

Yes 

Yes 

Yes 

No 

No 

No 

No 

Raw file transmit and capture 

Yes 

Yes 

Yes 

N/A 

Yes 

Yes 

Yes 
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Kermit Software Versions 


C-Kermit is only one of many Kermit software programs. As you can see from Table 1-2, 
which begins on the next page, Kermit is available for almost any kind of computer you 
can think of. Kermit software is written in a wide variety of programming languages, and 
source code is always available. 

The table does not show the hundreds of makes of computers and variations of operating 
systems for which C-Kermit, MS-DOS Kermit, and CP/M Kermit have been adapted. 
MS-DOS Kermit runs on countless IBM-compatible PCs and quite a few non-compatible 
models too. The CP/M versions have been adapted to about 70 different machines. The 
UNIX version of C-Kermit has been built successfully on at least 150 different platforms. 
Some of them are listed beginning on page 13, after Table 1-2. 

How to Get Kermit Software 


Kermit software can be ordered from Columbia University on 3.5-inch or 5.25-inch 
DOS-format diskettes, on 9-track magnetic tape in tar, ansi, or OS format, on quarter- 
inch tape cartridge in TAR format, on DEC TK50 tape cartridge in VMS BACKUP format, 
and possibly in other formats too. See the tear-out card in the back of this book. 

For an up-to-date catalog and mail-order instructions, and to be placed on the subscriber 
list for the free journal, Kermit News, write to: 

Kermit Distribution, Dept Cl 

Columbia University Center for Computing Activities 
612 West 115th Street 
New York, NY 10025, USA 
Phone: (USA) (212) 854-3703 

A modest distribution fee is charged for mail orders, depending on the materials, labor, 
and shipping costs involved. Various shipping and payment methods are available, and 
overseas orders are accepted. 

If you have access to the TCP/IP Internet, you can also get Kermit software via 
anonymous FTP to IP host kermit.columbia.edu. Begin by getting and reading the file 
kermit/read .me. If you have access to the BITNET (CREN) or EARN network, send 
electronic mail to KERMSRV8CUVMA containing the text HELP for instructions. You can 
subscribe to the electronic Info-Kermit Digest by sending e-mail containing the text: 
SUBSCRIBE I$KERMIT your-name-here 

to LISTSERV@CUVMA.CC.COLUMBIA.EDU or to LISTSERV0CUVMA.BITNET, or 
you can read it in the COMP.PROTOCOLS.KERMIT newsgroup. 
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Table 1-2 Kermit Software Listed by Computer Type 
Implementation Computer OS 


C-Kermit 

MS-DOS Kermit 

Kermit-80 

Kermit-86 

Kermit-TD 

PICK-Kermit 

Kermit-UCSD 

BBC-Kermit 

Kermit-65 

Mac-Kermit 

Atari-Kermit 

C-Kermit 

Kermit-CT 

Kermit-B78 

Kermit-B68 

Kermit-B78 

Kermit-B79 

Kermit-CD3 

Kermit-CDC 

Kermit-CYB 

Kermit-NOS 

CC-Kermit 

Kermit-C64 

Kermit-C64 

C-Kermit 

Kermit-CT 

Cray Kermit 

Cray Kermit 

C-Kermit 

Kermit-12 


many 

many 

many 

many 

various 

various 

various 

Acorn BBC 

Apple II 

Apple Macintosh 
Atari 800 
Atari ST 
Burroughs B20 
Burroughs A-Series 
Burroughs B6800 
Burroughs B7800 
Burroughs B7900 
CDC Cyber 
CDC Cyber 
CDC Cyber 
CDC Cyber 
Chinese PCs 
Commodore 64 
Commodore 128 
Commodore Amiga 
Convergent NGEN 
Cray-1 
Cray-XMP 
DEC Alpha AXP 
DEC PDP-8 


UNIX 

MS-DOS 

CP/M-80 

CP/M-86 

TurboDos 

PICK 

UCSD p-System 
Acorn OS 
DOS, PRODOS 
Mac OS 
DOS 

GEMDOS 

BTOS 

MCS/AS 

Burroughs 

Burroughs 

Burroughs 

NOS 

NOS, NOS/BE 

NOS 2.2 

NOS 2.4 

CC-DOS 

DOS 

DOS 

AmigaDOS 

CTOS 

CTSS 

CTSS 

Open VMS, OSF/1 
OS/8 


Language 

C 

8088 Assembler 
8080 Assembler 
8088 Assembler 
8080 Assembler 
DATA/BASIC 
UCSD Pascal 
6502 Assembler 
6502 Assembler 
C 

Action 

C 

C 

Algol 

Algol 

Algol 

Algol 

Fortran-5 

Fortran-77 

Compass 

Compass 

8088 Assembler 

6510A Assembler 

6510A Assembler 

C 

c 

Fortran-77 

Fortran-77 

C 

PAL-8 Assembler 
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Table 1-2 Kermit Software Listed by Computer Type (continued) 
Implementation Computer OS Language 


Kermit-11 

DEC PDP-11 

Kermit-11 

DEC PDP-11 

Kermit-11 

DEC PDP-11 

Kermit-11 

DEC PDP-11 

Kermit-11 

DEC PDP-11 

MUMPS Kermit 

DEC PDP-11 

Kermit-12 

DEC PDP-12 

Kermit-11 

DEC Pro-3xx 

Kermit-11 

DEC Pro-3 xx 

C-Kermit 

DEC VAX 

C-Kermit 

DEC VAX 

Kermit-12 

DECmate I, II, III 

C-Kermit 

DECstation 

Kermit-10 

DECsystem-10 

Kermit-20 

DECS Y STEM-20 

C-Kermit 

Data General MV 

Kermit-RDOS 

Data General Nova 

GEC-Kermit 

GEC 4000 

Gould Kermit 

Gould/SEL 32 

HPM-Kermit 

HP 1000 

Rover-Kermit 

HP 264x 

HP3-Kermit 

HP 3000 

HPB-Kermit 

HP 9xxx 

HPP-Kermit 

HP 9xxx 

Aegis Kermit 

HP/Apollo 

HP8-Kermit 

HP86, HP87 

Kermit-HlOO 

Harris 100 

Kermit-H800 

Harris 800 

MULTICS-Kermit 

Honeywell 

HG-Kermit 

Honeywell DPS6 


IAX 

Macro-11 Assembler 

RSTS/E 

Macro-11 Assembler 

RSX-11 

Macro-11 Assembler 

RT-11 

Macro-11 Assembler 

TSX+ 

Macro-11 Assembler 

MUMPS 

MUMPS-82 

OS/12 

PAL-8 Assembler 

P/OS 

Macro-11 Assembler 

Pro/RT 

Macro-11 Assembler 

ULTRIX 

C 

VMS, Open VMS 

C 

OS/278 

PAL-8 Assembler 

ULTRIX, OSF/1 

C 

TOPS-10 

MACRO-10 Assembler 

TOPS-20 

MACRO-20 Assembler 

AOS/VS 

C 

RDOS 

BASIC or Fortran-5 

OS4000 

MUM/SERC 

MPX-32 

Fortran-77+ 

RTE 

Fortran-77, Assembler 

ROM 

8080 Assembler 

MPE 

SPL 

HP BASIC 

HP BASIC 

HP Pascal 

HP Pascal 

Aegis 

Pascal 

HP BASIC 

HP BASIC 

VOS 

Fortran-77 

VOS 

Pascal, Assembler 

MULTICS 

PL/I 

GCOS 

C 
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Table 1-2 Kermit Software Listed by Computer Type (continued) 


Implementation 

Computer 

OS 

Language 

HB-Kermit 

Honeywell DPS8 

GCOS 

B 

HC-Kermit 

Honeywell DPS8 

CP-6 

PL/6 

CS9-Kermit 

IBM CS9000 

CSOS 

Pascal 

MS-DOS Kermit 

IBM PC, PS/2 

MS-DOS 

C, 8088 Assembler 

MS-DOS Kermit 

IBM PC, PS/2 

MS-Windows 

C, 8088 Assembler 

Windows Kermit 

IBM PC, PS/2 

MS-Windows 

C 

Kermit-370 

IBM mainframe 

CICS 

370 Assembler 

Kermit-370 

IBM mainframe 

MUSIC 

370 Assembler 

Kermit-370 

IBM mainframe 

MVS/ROSCOE 

370 Assembler 

Kermit-370 

IBM mainframe 

MVS7TSO 

370 Assembler 

Kermit-370 

IBM mainframe 

VM/CMS 

370 Assembler 

GUTS-Kermit 

IBM mainframe 

MVS/GUTS 

370 Assembler 

MTS-Kermit 

IBM mainframe 

MTS 

PLUS, Pascal, Assembler 

VME-Kermit 

ICL 2900 

VME 

S3 

Perq-Kermit 

ICL/Perq 

Perq OS 

Pascal 

Kermit-ISIS 

Intel MDS 

ISIS 

PL/M 

Kermit-MDS 

Intel MDS 

iRMX 

8088 Assembler 

Kermit-RMX 

Intel MDS 

RMX 

PL/M 

Kermit-LMI 

LMI LISP Machine 

LMI-LAMBDA 

ZETALISP 

Kermit-Lilith 

Lilith Workstation 

MEDOS 

Modula-2 

ABC-Kermit-80 

Luxor ABC-80 

ABC-DOS 

Z80 Assembler 

ABC-Kermit 

Luxor ABC-800 

ABC-DOS 

ABC-BASIC-II 

Kermit-B4 

MAI Basic Four 

BOSS/VS 

BASIC BB86 

Kermit-MODCOMP 

MODCOMP Classic 

MAX IV 

Fortran, Assembler 

Flex-Kermit 

Motorola 6809 

Flex 

C or Assembler 

C-Kermit 

Motorola 680x0 

OS-9 

C 

Kermit-9800 

NCR 9800 

VE 

C 

MS-DOS Kermit 

NEC PC9801 

MS-DOS 

C, Assembler 

Kermit-ND 

Norsk Data 

Intran HI 

ND-Pascal 

C-Kermit 

PC, PS/2 

OS/2 

C 
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Table 1-2 Kermit Software Listed by Computer Type (continued) 


Implementation 

Computer 

OS 

Language 

Kermit-PE 

Perkin-Elmer 3200 

OS/32 

Fortran 

Kermit-PE7 

Perkin-Elmer 7000 

IDRIS 

C 

Prime-Kermit 

Prime 

PRIMOS 

PL/P 

Kermit-RML 

RML480Z 

ROS 

C 

Kermit-QL 

Sinclair QL 

QDOS 

C or BCPL 

Kermit-1100 

Sperry 1100 

Exec 

Assembler or Pascal 

Kermit-VS9 

Sperry 90/60 

VS9 

Assembler 

Kermit-LMS 

Symbolics 36xx 

Symbolics 

ZETALISP 

Kermit-TI990 

TI990 

DX10 

Pascal 

Kermit-TIX 

TI Explorer 

LISP 

Common LISP 

Kermit-CoCo 

TRS-80 CoCo 

DOS 

EDTASM Assembler 

Kermit-TRS80 

TRS-801, n, HI 

TRSDOS 

8080 Assembler 

Kermit-M4 

TRS-80 Model 4 

TRSDOS 

8080 Assembler 

Tandem-Kermit 

Tandem Nonstop 

Guardian 

TAL 

Kermit-TlOO 

Tandy 100 

Tandy 100 

BASIC 


UNIX C-Kermit Versions 

As of this writing, C-Kermit 5A(188) has been tested successfully on 16-bit, 32-bit, and 
64-bit architectures under portable UNIX versions including 4.2 and 4.3BSD, 4.4BSD- 
Alpha, AT&T UNIX System HI, AT&T UNIX System V Releases 2, 3, and 4, POSIX, 
OSF/1, and Solaris versions 1 and 2. This version of C-Kermit has also been built and 
tested successfully on the following specific platforms: 

Altos ACS68000 with UNIX System III R2; Apollo workstations with DomainOS SR 10.0 
and 10.4; Amdahl mainframes with UTS UNIX 5.2.6b; Apple Macintosh II with A/UX; 
AT&T 3B2 and 3B20 systems with UNIX System V R2; AT&T 6300 PLUS with UNIX 
System V R2; AT&T 6386 WGS UNIX PC with UNIX System V/386 3.2; AT&T PC 
7300 UNIXPC (3B1) System V R3.51m; Commodore Amiga with UNIX System V R4; 
Concurrent (Masscomp) computers with RTU 4.0 through 6.0; Concurrent (Perkin-Elmer) 
computers with Xelos System V R02; Convergent Technologies MiniFrame with CTIX 
System V R3; Convex Cl and C2 with Convex/OS 8.x and 9.x; Convex 3240, C220, and 
C240 with ConvexOS VIO.x; Cray Y/MP with UNICOS 6.1 and 7.0; DEC Alpha AXP 
and DECstation with OSF/1; DEC PDP-11 with 2.11BSD; DEC VAX with 4.2BSD, 
4.3BSD, 4.3BSD-Reno, 4.3BSD-Networking/2; DEC VAX with ULTRIX 1.0, 2.0, 3.0, 
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4.0,4.2, and 4.3; DEC VAX with AT&T System V R3; DECstation with ULTRIX 4.2 and 
4.3; Data General Aviion with DG/UX 5.4, 5.4.1, and 5.4.2; DIAB DS90 with DNIX 5.3; 
Dolphin Server Technology Triton 88/17 with Dolphin UNIX System V/88 R3.2; Encore 
Multimax with UMAX 4.3; Fortune 32:16 with ForrPro 2.1; Harris Night Hawk 68K and 
88K with CX/UX; HP-9000 with HP-UX 5.21, 5.5, 7.0x, 8.0x; IBM 370-series 
mainframes with AIX/370 1.2; IBM PS/2 with AIX 1.2; IBM RS/6000 AIX 3.1 and 3.2; 
IBM RT PC with AIX 2.x and 4.3BSD-Reno; ICL DRS3000 and DRS6000 with DRS/NX 
UNIX System V R4; Integrated Solutions VS8 with ISI 4.2BSD; MIPS Computer Sys¬ 
tems with RISC/OS UMIPS 4.52; Modcomp Realstar 1000 with REAL/IX D.l; Motorola 
VME Delta Series with System V/68 R3 and System V/88 R32 and R40; NCR Tower 32 
with OS 2.01; NeXT workstations with Mach 1.0, 2.1, and 3.0; Nixdorf Targon/31 M15 
with TOS 4.0.13; Norsk Data Uniline 88/17 with System V/88 R3.2; Olivetti CP 486 with 
UNIX System V R4; Olivetti LSX 3005 through 3045 with X/OS UNIX 2.3 through 3.0; 
Olivetti LSX 5020 with SCO UNIX 3.2.2; PCs with 386BSD (Jolix); PCs with AT&T 
UNIX System V R3.2; PCs with BSDI/386; PCs with Dell UNIX System V/386 R4.04 is¬ 
sue 2.2; PCs with ESIX System V R3 and R4; PCs with Interactive Systems Corporation 
System V/386 3.x; PCs with Linux/386; PCs with Mark Williams COHERENT/386 4.0; 
PCs with MINIX/386; PCs with Microport 3.0U3 and SVR4.0 V4.1; PCs with SCO ODT 
1.1 and 2.0; PCs with SCO UNIX/386 3.2.x; PCs with SCO Xenix/286 2.3.3; PCs with 
SCO Xenix/386 2.2.x and 2.3.x; PCs with SunSoft Solaris 1.0; Pyramid MIS-T Series 
with OSx 5.1a; Sequent Symmetry with DYNIX 3.x and DYNIX/ptx 1.3 and 1.4; Silicon 
Graphics Iris with IRIX 3.3; Silicon Graphics Indigo with IRIX 4.0.x; Solboume 5E/900 
with OS/MP 4.1 A; Sony NEWS with NEWS-OS 4.x; Stardent 1520 UNIX System V R3 
2.2; Sun workstations, computers, and servers with SunOS 3.2 through 5.1; Tandy Model 
6000 with XENIX 3.2; Tektronix 6130 with UTek OS; UNISYS S/4040 with CTIX 
SVR3.2; UNISYS U6000/65 MP with UNIX System V R4. 

During its development, the UNIX version of C-Kermit 5A was also tested successfully 
on the following machines and operating systems: 

Alliant FX/8 with Concentrix 4.1; Altos 486, 586, 986 with Xenix 3.0; Atari ST with 
MINIX ST 1.5.10.3; Bell Laboratories UNIX 7th Edition; Berkeley UNIX 4.1BSD; 
Charles River Data Systems Universe 680x0 with UNOS 9.2; Data General Aviion with 
DG/UX 4.30; FPS 500 with FPX 4.1; IBM RT PC with ACIS 4.2 and 4.3; Intel 302 with 
Bell Tech System V/386 R3.2; Luxor ABC-9000 with DNIX; NCR System 3000 with 
AT&T UNIX System V R4 2.0; NCR Tower 1632 and Minitower with System V R2; 
OkiStation 7300 Series; PCs with Consensys UNIX SV/386 R4V3; PCs with Mt Xinu 
Mach 386 ; PFU Compact A Series with SX/A TISP V10/E50; Ridge 32 with ROS 3.2; 
Samsung MagicStation with System V R4; Sequent Balance 8000 and B8 with DYNIX 
3.0; Tektronix XD88 series with UTekV OS; Tri Star Flash Cache with Esix SVR3.2; 
UNISYS 5000 with UTS V R5.2 and 5.3. 
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Chapter 2 


Running C-Kermit 


C-Kermit is a large program with many features, designed to be used on a wide variety of 
hardware and software platforms. If your computer does not have enough memory or 
does not offer certain capabilities, some of the C-Kermit features described in this book 
might not be available. C-Kermit’s SHOW FEATURES command lists the features that are 
included and those that are missing. See the Appendix particular to your operating sys¬ 
tem, such as Appendix III for UNIX. 

This book describes C-Kermit version 5A(188). If you are running an earlier version, you 
should get the latest release (see page 9). If you have a later version, consult the file 
ckcker . upd for notes about changes that were made since this book was published. 

Starting C-Kermit 

Remember, in the examples used throughout this book, the characters that you 
type are underlined. The characters that are not underlined are prompts or mes¬ 
sages from the computer. 

If the C-Kermit program is correctly installed on your computer, you should be able to run 
it simply by typing its name at the system prompt (which is shown as dollar sign in this 
example, but might be some other character or text): 

$ kermit 
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In response, you should see a herald and a prompt looking something like this: 3 

C-Kermit 5A(188), 23 Nov 92, OpenVMS AXP 

Type ? or HELP for help 

C-Kermit> 

What do the herald and prompt tell us? c-Kermit is the name of the program. 5A( 188) 
is the version number: the major release number is 5, the minor release, or level, is A, the 
edit number is 188, and the program release date is 23 Nov 92. OpenVMS AXP is an 
identifier for the type of computer and operating system that C-Kermit was configured for. 

The prompt, c-Kermit>, means that C-Kermit is ready for a command. The line above 
the prompt, Type ? or HELP for help, means just what it says. If you type a question 
mark at the prompt, you get a list, or menu, of commands that are available at that point. 
These are C-Kermit’s top-level commands. If you type the word help , you get a brief in¬ 
troduction to Kermit’s “user interface”—how to enter and edit commands and how to get 
more help. 

C-Kermit’s command style should be familiar to anyone who has used MS-DOS Kermit 
or other popular Kermit programs. A Kermit command is like an English sentence, 
usually consisting of a verb followed by objects. When the C-Kermit prompt appears, you 
can type a command. Commands are entered using ordinary letters, numbers, and 
punctuation, plus the special characters that are summarized in Table 2-1 on page 24. A 
command is executed only after you press the Return or Enter key. When the command 
has finished executing, the prompt appears again and you can type another command, and 
so on: 

C-Kermit >version 

C-Kermit 5A(188), 23 Nov 92, OpenVMS AXP 
Numeric: 501188 
C-Kermit >echo Hello 
Hello 

C-Kermit> check character-sets 
Available 
C-Kermit> 

This style of operation is called interactive command mode , and it gives you full access to 
all of C-Kermit’s features. 


3 If instead you see an error message such as “not found”, “permission denied”, or “unrecognized 
command verb”, the program has not been installed or wasn’t installed correctly. Or maybe it was 
installed with some other name, perhaps “ckermit” or “wermit.” If you see a “Usage” message, 
beginning something like: 

Usage: kermit [-x arg [-x arg-]... [-yyy]... ] 

then you have either a very, very old version of C-Kermit, or else version 5A has been installed without 
an interactive command parser. 
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By the way, if you don’t like C-Kermit’s prompt, you can change it to suit your tastes: 

C-Kermit> set prompt My Favorite Proqram> 

My Favorite Program> 

or, less frivolously: 

C-Kermit> set prompt VAX-Kermit> 

VAX-Kermit> 

to remind you that you are using Kermit on a VAX. Later when you start to use Kermit to 
talk to two computers at once, this will help you keep track of which one you’re talking to. 

Exiting from C-Kermit 

When you are finished using C-Kermit, type the command EXIT or quit and then press the 
Return or Enter key to return to the system prompt: 

C-Kermit>exit 

$ 

The system prompt varies with your operating system and other circumstances. When 
C-Kermit exits, it closes any files it might have had open, restores your command terminal 
to normal, and generally cleans up after itself. See page 331 for a complete description of 
the exit command. 

Entering Interactive Commands 

Kermit’s interactive command language is easy for users of all levels. For novices, it is 
intuitive and nonthreatening. Commands are normal English words rather than cryptic 
codes. Help is available when you need it, but unlike a menu system, it does not force it¬ 
self upon you when you don’t want it. Later, when you become familiar with Kermit’s 
commands, you will be able to enter them more quickly by using abbreviations, or even 
condensing multiple commands into short “macros,” described in Chapter 11. 

A command consists of one or more words separated by spaces, like a sentence. The 
words are called fields. In a Kermit command, a field can be a keyword, a file name, a 
number, or some other quantity. A keyword is a word chosen from a particular list; all 
words on that list are valid, other words are not. 

Commands begin with a keyword, normally an English verb like send, receive, or set. 
Keywords can be entered in uppercase or lowercase, or any combination. We show com¬ 
mand keywords within running text in UPPERCASE for clarity (for example, the SEND com¬ 
mand) but in lowercase in examples: 

C-Kermit> send oofa.txt 

because that is how people normally type them. 
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Getting Help within a Command 

A question mark (?), typed at any point in a command, produces a message explaining 
what is possible or expected at that point. Depending on the context, the message can be a 
brief explanatory phrase, a menu of valid keywords, or a list of files. If you type a ques¬ 
tion mark at the prompt, you’ll see a list of all C-Kermit’s top-level commands. If you 
type a letter s at the prompt and then question mark, you’ll see a list of the commands that 
start with s: 

C-Kermit>s? 

Command, one of the following: 

script send server set 

show space statistics stop 

C-Kermit>s 

After the help message is displayed, you can continue the command from where you left 
off. The s is still there, and now you can type a letter e and another question mark to see 
which commands start with se: 

C-Kermit>se? 

Command, one of the following: 

send server set 

C-Kermit>set 


You can continue this process to the next field of the command by typing a space and then 
another question mark: 


:-Kermit>set ? 

Parameter, one of the 

following: 


attributes 

background 

block-check 

buffers 

carrier 

case 

command 

count 

delay 

dial 

duplex 

escape 

file 

flow-control 

handshake 

host 

input 

key 

language 

line 

macro 

modem-dialer 

network 

parity 

prompt 

quiet 

receive 

retry 

many more are 

shown ... 




This tells you that Kermit wants you to type another keyword, the parameter that you want 
to SET. Kermit lists all the possibilities for you, such as SET file. Let’s see how far we 
can go with the SET FILE command. 

C-Kermit>set file ? File parameter, one of the following: 
bytesize character-set collision display 

names type 

C-Kermit>set file type ? type of file, one of the following: 

binary text 

C-Kermit>set file type binary ? 

Type a carriage return to confirm the command 
C-Kermit>set file type binary <CR> 

C-Kermit> 

At the end of the command, press the Return, Carriage Return, or Enter key (shown 
above, for emphasis, as <CR>) to have C-Kermit actually execute the command. Linefeed, 
Ctrl-J, Formfeed, and Ctrl-L also serve the same purpose. 
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We seem to have prepared C-Kermit for transferring binary files. Let’s look at the com¬ 
mand that actually sends the file: 

C-Kermit> send ? File(s) to send 
C-Kermit>send 

At this point, you need to type the name of an existing file. Let’s say you have forgotten 
its exact name, but you know it starts with the letter 0. So you type an 0 and then a ques¬ 
tion mark to have Kermit list the files whose names start with 0, you pick the right one, 
and then you enter the command: 

C-Kermit>send o? File(s) to send, one of the following: 

oofa.bin oofa.doc oofa.hlp oofa.txt 

C-Kermit>send o ofa.txt 

Return to your local Kermit and give a RECEIVE command. 

KERMIT READY TO SEND... 

If your command doesn’t make sense or it contains spelling or grammatical errors, Kermit 
gives you a brief error message and a new prompt: 

C-Kermit> sned ?No keywords match: sned 
C-Kermit> 

No harm is done by spelling errors in keywords (unless your error corresponds to another 
valid keyword). An invalid command is not executed, and it has no side effects. But 
watch out for spelling errors in filenames or numbers, where Kermit usually has no way to 
tell the difference between what you typed and what you meant to type. 

Abbreviating Keywords 

You don’t have to spell keywords out in full; you can abbreviate them as much as you 
want, as long as the result isn’t ambiguous within its field. For example, the shortest way 
to enter the set file type binary command would be: 

C-Kermit >set fi t b 

If you abbreviate a keyword too much, Kermit complains that your command is 
“?Ambiguous.” No harm is done, and the command is not executed: 

C-Kermit> se ?Ambiguous - se 

C-Kermit >se? Command, one of the following: 

send server set 

C-Kermit> 

Some command keywords are used so frequently that they have special one-letter ab¬ 
breviations, even though more than one command begins with that letter. These include C 
for connect, s for send, and R for receive. For example, the command: 

C-Kermit> s oofa.doc 

sends the file oof a. doc. Note that filenames can not be abbreviated. 
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Correcting Mistakes in Commands 

If you make typographical errors or change your mind about a command before you enter 
it, you can alter or cancel it using the following special characters: 

DEL (The Delete, Rubout, or Backspace key, or Ctrl-H) Deletes the rightmost character 
from the command. 

(Ctrl-W) Erases the rightmost word from the command. 

A U (Ctrl-U) Erases the entire command. 

(Ctrl-R) Redisplays the current command. 

The notation A X or Ctrl-X means press the key marked X while holding down the key 
marked Ctrl or Control. X can be any letter A-Z, and also certain punctuation characters 
such as underscore (_), reverse slash (\), caret (*), or right bracket (]). 4 The Ctrl key is 
used like the Shift key. Characters entered in conjunction with the Ctrl key are called 
control characters. You can type the editing characters DEL and repeatedly to delete 
all the way back to the prompt. 

C-Kermit tries to keep your command line looking right: deleted characters, words, and 
lines “disappear” but the prompt stays where it was. But there are ways for the command 
line to become jumbled (for example, if someone sends you a message while you’re in the 
middle of typing a command). That’s what Ctrl-R is for; it redisplays the prompt and the 
current command, properly formatted: 

C-Kermit >set fi 

<BEEP>From olafs What do you want on your pizza? 
le type^R 

C-Kermit >set file type 

Keyword and Filename Completion 

C-Kermit has a special reinforcement mechanism to help you make sure you have not ab¬ 
breviated a keyword too much, or that the abbreviation you have used really stands for 
what you think it does, or to finish typing a filename for you. 

This mechanism is called completion, and you invoke it by pressing the Esc (Escape) or 
Tab key, or Ctrl-I, whichever is more convenient for you. If the keyword or filename 
characters you have typed so far are sufficient, Kermit fills in the rest of the characters for 
you and positions you for the next field of the command: 

C-Kermit>sen<ESC>d oofa.t<ESC>xt 


4 See Table VK-l on page 461 for a listing of all the control characters. 
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If not, Kermit beeps and waits for you to supply more characters: 
C-Kermit> se<ESC> <BEEP >n<ESC> d oofa. <ESC> <BEEP >t<ESC> xt 

In these examples, <esc> signifies the Escape (Esc) key, and <beep> shows where you 
would hear a beep. If you are deaf, you can still tell when a beep occurs: whenever you 
press <ESC> and the cursor does not move. 

When you use the completion feature in a filename, C-Kermit completes as much of the 
name as it can, and if more characters are required from you after that, C-Kermit beeps 
and waits for you to supply them. For example, suppose you have two files, oof a. txt 
and oof a. new, and they are the only two files whose names start with the letter O. If 
you type an O and then an Esc or Tab, Kermit supplies the characters “ofa.” and then 
waits for you to finish the filename: 

C-Kermit >send o<ESC> ofa.<BEEP >t<ESC> xt 

The completion feature also can be used to fill in default values for fields that have them. 
If you press the Esc or Tab key at the beginning of a field, before typing any other charac¬ 
ters, and if that field has a default value, Kermit fills it in: 

C-Kermit> set block-check <ESC> 1 

Here Kermit supplies the default block-check value, namely 1. If there is no default value 
for a field, Kermit beeps: 

C-Kermit> send <ESC> <BEEP> 

When the final field of a command has a default value, you can enter the command with¬ 
out specifying a value: 

C-Kermit> set block-check 

This sets the block-check parameter to its default value of 1. 

Including Special Characters in Commands 

Characters like question mark and Ctrl-U have special meanings within C-Kermit com¬ 
mands. What if you need to include them as part of the command itself without triggering 
their usual functions (help and erase)? You can enter such a character into a C-Kermit 
command literally by preceding it with the backslash character (\), for example: 

\? 

To enter a backslash literally, type two of them: 

\\ 

Certain characters, however, such as Ctrl-C or Ctrl-Z (depending on your computer’s 
operating system), cannot be quoted this way because they send a signal to the operating 
system to interrupt Kermit. 
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You can include problem characters in Kermit commands by using a backslash followed 
by the character’s numeric ASCII code value; for example \3 for Ctrl-C, \26 for Ctrl-Z, 
\10 for linefeed, or \13 for carriage return (Table VIII-1 on page 461 lists these codes). 
Example: 

C-Kermit >echo Hellol\13\10How are you\? 

Hello 1 

How are you? 

C-Kermit> 

A common use for backslash is to include ? as a wildcard 5 in a file specification: 

C-Kermit> send oofa.? File(s) to send, one of the following: 
oofa.c oofa.h oofa.txt oofa.hip 

C-Kermit> send oofa.\? 

Without the backslash, the question mark gives you a list of filenames that match what 
you have typed so far. With the backslash, it is used to match any single character, so the 
SEND command in the example sends the files oofa.c and oofa.h. 

In OS/2 and Atari GEMDOS the directory separator is backslash, the same as C-Kermit’s 
quoting character. To include a backslash in a filename, use two of them: 
C-Kermit >send c:\\dos\\autoexec.bat 

This also applies when using C-Kermit to transfer files with MS-DOS Kermit. For¬ 
tunately, in OS/2, forward slash (/) is also recognized as a directory separator: 

C-Kermit >get c:/dos/autoexec.bat 


Interrupting a Command 

After you have entered a C-Kermit command by pressing the Return or Enter key, the 
command begins to execute. You can interrupt most commands during their execution by 
typing Ctrl-C (hold down the Ctrl key and press the C key). 6 

This returns you to the C-Kermit prompt immediately, so you can enter another command. 
Example: 

C-Kermit> type moon.doc 

No celestial body has required as much labor for the study of its 
motion as the moon. Since Clairault (1747), who indicated a way 
of constructing a theory containing all the properties of ... 
C-Kermit> 

Note: indicates a real Control-C character, not a circumflex followed by the letter C. 


5 A “wildcard” is a character used in a filename to indicate a group of files. Wildcard characters differ 
from system to system. See the Appendix for your system; for example. Appendix III for UNIX. 

^The interrupt character might be something other than Ctrl-C: for example, in 4.3BSD UNIX it is your 
“intr” character. 
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Command Files 


If you issue the same sequence of commands to Kermit every time you run it, that can add 
up to a lot of typing over the years. Better to enter the commands just once and let the 
computer remember them for you. Use your favorite text editor to record the commands 
in a Kermit command file and you won’t ever have to type them again. 

Kermit commands are lines composed of plain text characters. The text editor used to 
create or modify Kermit commands should be set up to handle these simple, unadorned 
lines of text. Editors like ED, EX, vi, and emacs are appropriate for UNIX. EDT, eve, and 
EMACS can be used in VMS or OpenVMS. SED or SPEED can be used in AOS [VS. 
Similar editors can be used in OS/2 and other operating systems. If you use a word 
processor or other utility that is concerned with fonts, boldface, italics, underscore, and 
similar frills, be sure to save your command file in plain-text (ASCII) format. To execute 
commands from a file, use the take command: 

TAKE filename 

Executes C-Kermit commands from the specified file. C-Kermit reads and executes 
the commands in order, from top to bottom, until the end of the file is encountered or 
until a command (such as EXIT) is executed that tells C-Kermit to stop. Example: 
C-Kermit> take CompuServe. tak 

Execution of a command file can be interrupted by typing Control-C (or whatever your 
system’s interrupt character is 7 ) at any time during its execution. If the TAKE command 
was given from the C-Kermit prompt, the interruption returns you directly to the prompt. 
The following sections describe features that are commonly used in command files, but 
you can also use them at the interactive program prompt. 

Adding Comments to Commands 

Kermit’s commands can be annotated with comments. A full-line comment can begin 
with the word comment or the single character semicolon (;) or number-sign (#): 

COMMENT - This is a C-Kermit command file. 

; I copied it from "Using C-Kermit". 

# And I put lots of comments in it. 

Commands can also have trailing comments. These are introduced by a semicolon or 
number-sign preceded by at least one space: 

echo Hi there! ; Print a friendly greeting. 

space ; Let's see how much disk space is free. 

log transactions ; X always want to keep a log of what I do. 


7 Ctrl-C is used in AT&T System V UNIX, even if your interrupt character is not Ctrl-C. 
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Table 2-1 Special Characters in C-Kermit Commands 


Character Function 


<SPACE> 

? 


\ 


# 

<ESC> 

<TAB> 

<DEL> 

Ctrl -H 


(the space bar) Separates fields. 

(question mark) Requests a menu or help message for the current field. 

(dash) At the end of a line only: this command is continued on the next 
line. 

(backslash) At the end of a line only: continues this command on the next 
line. Elsewhere within the command: introduces a backslash code or 
quotes the following character. Backslash codes are listed in Table 1-2. 

(semicolon) At the beginning of a command, or within a command 
preceded by at least one space or tab: introduces a comment. 

(number sign) Same as semicolon: introduces a comment. 

(Esc or Escape key, or Ctrl-[) Attempt to complete the cunrent field. 

(or Ctrl-I) Within a field, same as <esc>. Between fields, same as 
<space> (but only in command files). 

(or Backspace, or Rubout, or Ctrl-H) Deletes the rightmost character from 
the command. 

Same as <del>. 


Ctrl-I 

Ctrl-W 

Ctrl-U 

Ctrl-R 

Ctrl-C 


Ctrl-S 

Ctrl-Q 

Ctrl-Z 


Ctrl-Y 


<RETURN> 

<LINEFEED> 

<FORMFEED> 


Same as <tab>. 

Deletes the rightmost word. 

Deletes the entire command, back to the prompt. 

Redisplays the command. 

Interrupts a command in execution, returns to the prompt. On some UNIX 
systems, this purpose is served by your interrupt character, which might be 
something other than Ctrl-C. Use stty all or stty -a to find out what 
your interrupt (intr) character is. 

Stops screen output, if Xon/Xoff flow control is in effect. 

Resumes screen output, if Xon/Xoff flow control is in effect. 

Suspends Kermit so it can be continued later (UNIX only). On UNIX 
systems, this purpose is served by your suspend character, which might be 
defined as something other than Ctrl-Z. Use stty all or stty -a to 
find out what your suspend (susp) character is. 

In VMS or Open VMS, Ctrl-Y either interrupts the current command and 
returns to the prompt, or else it interrupts C-Kermit and returns to the DCL 
prompt in such a way that C-Kermit can be coNTiNUEd, depending on the 
context. In some UNIX systems, Ctrl-Y is a secondary suspend character. 

(Carriage Return, Return, Enter, Ctrl-M) Terminate and enter the com¬ 
mand. Also written as <CR>. 

(Ctrl-J) Same as <return>. Also written as <lf>. 

(Ctrl-L) Same as <return>. Also written as <ff>. 
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Because ; and # are recognized as trailing comment indicators only when preceded by 
whitespace, you can also include these characters literally in commands by preceding 
them with printing characters: 

get oofa.txt;3 ; Fetch file from VMS Kermit server, 

remote host lpr -#4 oofa.txt # Print 4 copies of remote file. 

In this example, oofa.txt;3 is a VMS filename, and lpr -# 4 is the UNIX command 
to print four copies of a file. 

If you need to include ; or # as part of a command and it must be preceded by a space, 
then quote it with backslash: 

C-Kermit >echo Text ; with a comment 
Text 

C-Kermit> echo Text \; with a comment 

Text ; with a comment 

C-Kermit> 


Continuing a Command 

Kermit commands are by nature one line long. Some Kermit commands, however, can be 
quite lengthy—even wider than your screen. There is nothing to prevent you from typing 
past the end of your screen, and if your terminal emulator or console driver “wraps” your 
lines for you, you can even see what you’re doing. 

But the compulsive among us may wish to break long commands at nice places, so as to 
have a neat-looking screen or, perhaps more important, neat-looking command files. 


C-Kermit commands can be continued by ending them with a dash (-) or a backslash (\) 
as the last character in the line: 


C-Kermit> set - 
file \ 


binary 

C-Kermit> 


Note that the prompt doesn’t come back until you (a) finish entering the command, (b) re¬ 
quest a menu with ?, or (c) make a mistake. In command files only (not at the prompt), 
you may add trailing comments after the continuation character: 

set - ; This is a SET command 

file - ; related to files 

type - ; in particular the file type 

binary ; which is to be binary. 


The command editing characters <DEL>, Ctrl-W, and Ctrl-U may be used with continued 
commands, but their effects are shown only on the current line. Use Ctrl-R to show the 
overall effect when you delete back into previous lines. 
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Describing Kermit’s Commands 

Before we can start explaining C-Kermit’s commands, we need some notational conven¬ 
tions for describing their syntax, or form. We use special punctuation and typography to 
show what fields are required, what fields are optional, and what type of data goes into a 
field, as in this typical command syntax description: 

Syntax. SET { RECEIVE, SEND } END-OF-PACKET [ number ] 

This example illustrates the use of boldface to represent keywords literally, italic braces to 
enclose a list of alternatives, italic square brackets to show an optional field, and a word in 
italics to show a substitutable parameter. Here is a complete listing of the notation used in 
this book: 

WORD 

An uppercase word in BOLDFACE means that the word should be typed literally. If 
it is a keyword (and it usually is), letters can be omitted from the end as long as what 
remains is enough to distinguish the word you have abbreviated from any other word 
that is valid in the same context. Letters may be typed in either lowercase or upper¬ 
case. For example, in: 

SET FILE TYPE BINARY 

all four words are keywords. 

word 

A word in italics is a parameter, which is to be replaced by an actual value of your 
choice. The word in italics indicates what sort of quantity is expected: a number, a 
filename, a directory-name, a variable-name, and so forth. For example, in: 

SET WINDOW number 

the word number is to be replaced by an actual number, like 4 or 10. 

[ anything=value ] 

Any word enclosed in italicized (slanted) square brackets is optional, meaning you 
don’t have to include it in the command. If you see square brackets that are not 
italicized, they should be taken as literal brackets that you should type. The =value 
portion shows the value that is used if you don’t specify one for this field, that is, the 
default value. Example: 

SET BLOCK-CHECK [ number=l ] 

This means that the set block-check command takes an optional number. If you 
enter the command without specifying a number, then 1 is used: 

C-Kermit> set block-check 2 
C-Kermit> set block-check 1 
C-Kermit>set block-check 
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{ something, something, something } 

Within italicized curly braces, a list of items separated by commas means that you 
should pick one of the items from the list. This notation is usually used for a list of 
keywords: 

SET FILE TYPE [ { TEXT, BINARY } =TEXT ] 

This shows that the possible file types are text and binary and if the command ends 
after the word type, text will be used. If you see braces that are not italic, { such as 
the ones around this phrase }, these are actually part of the command. 


An ellipsis (three dots) means that the preceding item can be repeated. Example: 
MSEND file [file [file [...]]] 
or, more compactly: 

MSEND file ... 

This means the msend (multiple send) command can be given with one or more 
filenames separated by spaces. 


Commonly used C-Kermit command parameters include: 


number 

A decimal (base 10) number, like 31 or 9024. You also can enter small positive num¬ 
bers (0-255) in octal (base 8) or hexadecimal (base 16) using backslash notation. If 
you don’t know what octal or hexadecimal notation are, don’t worry about it—skip the 
rest of this paragraph. Use \onnn for an octal number; that is, backslash followed by 
the letter O (upper- or lowercase) followed by one to three octal digits (which are 0 
through 7). For a hexadecimal number, use \xnn; that is, backslash followed by the 
letter X (upper or lower), followed by exactly two hexadecimal digits, which are 0 
through 9 and A through F. The letters A—F can be in uppercase or lowercase. 
Example: 

SET RETRY number 


means you can type commands such as: 

C-Kermit> set retry 13 
C-Kermit> set retry \13 
C-Kerxnit> set retry \d!3 
C-Kermit> set retry \o!5 
C-Kermit> set retry \xOD 


(A decimal number) 

(A decimal number) 

(A decimal number) 

(An octal number) 

(A hexadecimal number) 


The allowable range for the number depends on the command. If you enter a number 
that is out of range, an error message is given and the command has no effect: 

C-Kermit> set window 793 
?Sorry, 31 is the maximum 
C-Kermit> 
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filename 

The name of a file on the computer where you are running C-Kermit. The name can, 
but need not, include device and/or directory information. Upper- and lowercase let¬ 
ters are treated differently in UNIX filenames, but case does not matter in VMS, 

Open VMS, OS/2, AOS/VS, and most other operating systems. The filename may not 
contain wildcard characters. For example: 

TAKE filename 

means that the take command needs the name of a file on your computer: 
C-Kermit> take oo fa.* 

?Wildcards not allowed in command file name 
C-Kermit >take oofa.cmd 

C-Kermit> take $disk2:[olqa]oofa.cmd (A VMS or OpenVMS file) 

C-Kermit >take /usr/ivan/kermit/oofa.cmd (A UNIX or Amiga file) 
C-Kermit> take f; Wolaf\\kermitWoofa.cmd (An OS/2 or Atari file) 

Note the double backslashes in the OS/2 or Atari ST filename. 


filespec 

A file specification applying to the computer where you are running C-Kermit. Just 
like a filename, except it is allowed to (but need not) contain wildcard characters to in¬ 
dicate a group of files. Example: 


SEND filespec 


means you can give commands like: 


C-Kermit> send oofa.txt 
C-Kermit> send oofa.* 

C-Kermit> send *.* 

C-Kermit> send $disk2;[olga]*.cmd 
C-Kermit> take /usr/ivan/kermit/*.ini 
C-Kermit>take f: \\olaf WkermitW* . * 


(A single file) 

(A group of files) 

(A bigger group of files) 
(VMS or OpenVMS files) 
(UNIX, OS-9, Amiga files) 
(OS/2 or Atari ST files) 


File specifications can also include device, directory, or other identifying fields mean¬ 
ingful to your operating system. 


remote-filename 

The name of a file on another computer, in whatever form the other computer requires. 
It should not contain wildcard characters. Example: 

REMOTE TYPE remote-filename 


lets us give commands like: 

C-Kermit> remote type oofa txt a 
C-Kermit> remote type f; \\olafWoofa.txt 
C-Kermit> remote type $disk2:[olaf1oofa.txt;17 
C-Kermit >remote type :udd:olaf:oofa.txt 
C-Kermit> remote type -olaf/oofa.txt 
C-Kermit >remote type diska:/olaf/oofa.txt 


(A VM/CMS file) 
(MS-DOS or OS/2) 
(VMS or OpenVMS) 
(AOS/VS) 

(UNIX or OS-9) 
(Amiga) 
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remote-filespec 

Just like remote-filename, but wildcard characters may (but need not) be included. 
Wildcards, if used, should be in a format acceptable to the other computer. Example: 

GET remote-filespec 
allows: 

C-Kermit> qet * exec (Files from VM/CMS) 

C-Kermit >get f : WolafWoofa. * (From MS-DOS or OS/2) 

C-Kermit> qet $disk2: r olaf 1 oofa .*;0 (From VMS or OpenVMS) 
C-Kermit> remote type :udd:olafroofa.- (From AOS/VS) 

directory-name 

The name of a directory on the computer where C-Kermit is running. Upper- and 
lowercase letters are distinct in UNIX directory names, but case does not matter in 
most other operating systems. Example: 

CD directory-name 
allows: 

C-Kermit> cd /usr/olga/ (UNIX) 

C-Kermit> cd c;\\usr\\olga (OS/2) 

C-Kermit> cd sys$help: (VMS or OpenVMS) 

C-Kermit> cd :udd:olga (AOS/VS) 

remote-directory-name 

The name of a directory on another computer, in whatever form the other computer re¬ 
quires. Example: 

REMOTE CD remote-directory-name 
allows: 

C-Kermit> reniote cd cl (VM/CMS) 

C-Kermit> remote cd f:\\public (OS/2 or MS-DOS) 

C-Kermit> remote cd [-.programs 1 (VMS or OpenVMS) 

C-Kermit> remote cd *:programs (AOS/VS) 

command 

In most contexts, a system command on the computer where C-Kermit is running, 
such as you would type to the UNIX shell, to DCL in VMS or OpenVMS, or to the 
CLI in AOS/VS. Alphabetic case matters in UNIX, but it does not matter in most 
other operating systems. Example: 

RUN command 
allows: 

C-Kermit> run diff oofa.old oofa.new (A UNIX command) 
C-Kermit> run purqe/log oofa.* (A VMS command) 

C-Kermit> run more < ckermit.ini (An OS/2 command) 

C-Kermit> run help/v copy (An AOS/VS command) 


Describing Kermit’s Commands 29 



C-Kermit> run status 
C-Kermit>run deldir test 


(An Amiga command) 
(An OS-9 command) 


In other contexts, command stands for a C-Kermit command. 
remote-command 

The name of a command or program on another computer, in the form required by the 
other computer. Example: 

REMOTE HOST remote-command 
allows: 

C-Kermit> remote host If oofa * (date (A command for VM/CMS) 
C-Kermit> remote host mkdir hw2 (A command for UNIX) 


text 

Any old text. Zero or more words, everything you type up to the end of the command. 
As in all C-Kermit commands, trailing comments are ignored. Example: 

ECHO text 
allows: 

C-Kermit >echo (No words) 

(A blank line appears) 

C-Kermit> echo Hi ; This is a comment (One word, with comment) 

Hi 

C-Kermit> echo Time to go home (Several words) 

Time to go home 
C-Kermit> 

Some Basic C-Kermit Commands 


You already know Kermit’s exit command. C-Kermit also includes a few other com¬ 
mands that you can experiment with right now, before you learn how to use the program 
for data communication and file transfer. These commands, listed in Table 2-2, give you 
access to file management and other functions of your computer’s operating system. Use 
these commands to practice the features you’ve read about in this chapter: question mark 
to get help, completion, abbreviation, correction, continuation, and comments. Within a 
few minutes you should be comfortable with C-Kermit’s command style and an expert 
navigator of Kerrnit commands. 

The Kermit command shown in the first column of the table is the form used in C-Kermit 
and most other Kermit programs. The equivalent commands in UNIX, VMS, Open VMS, 
AOS/VS, and other operating systems might have different names, but in many cases 
these names are accepted by Kermit too, so you don’t have to remember two different 
commands for the same task. 
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Table 2-2 Basic C-Kermit Commands 


Kermit 

UNIX 

VMS, OpenVMS 

AOS/VS 

Description 

cd 

cd 

set default 

directory 

Change directory 

delete 

rm 

delete 

delete 

Delete files 

directory 

Is -1 

directory 

filestatus 

List files 

echo 

echo 

write 

write 

Display text on screen 

help 

man 

help 

help 

Display help messages 

pause 

sleep 

wait 

pause 

Sleep for some seconds 

print 

lp, lpr 

print 

print 

Print files on a printer 

push 

sh, csh, ksh 

spawn, @ 

push 

Enter system 

pwd 

pwd 

show default 

dir 

Show current directory 

rename 

mv 

rename 

rename 

Rename files 

run 

command 

[ run ] command 

[ xeq ] 

Run a command or program 

space 

df 

show quota 

space 

Show disk space 

type 

cat 

type 

type 

Display contents of a text file 


Here are the descriptions of the commands from the table: 


CD [ directory-name ] 

Changes your default directory (CD stands for Change Directory). If you specify a 
directory name, it becomes your new default directory for all file-related Kermit com¬ 
mands. The directory name can be fully specified or it can be relative to your current 
directory. If you omit the directory name, most versions of C-Kermit put you back in 


your login directory. Examples: 

C-Kermit> cd $diskl:folga.letters] 
C-Kermit >cd r•letters] 

C-Kermit> cd /usr/olqa/letters 
C-Kermit> cd zuddsolga:letters 
C-Kermit >cd c: WolgaWletters 
C-Kermit >cd c:/olqa/letters 
C-Kermit >cd c;WolgaWletters 
C-Kermit> cd c;/olqa/letters 
C-Kermit> cd -olaf 
C-Kermit> cd letters 
C-Kermit>cd 


(Fully specified, VMS) 
(Relative directory, VMS) 
(Fully specified, UNIX) 

(Fully specified, AOS/VS) 
(Fully specified, OS/2) 
(Alternate form, OS/2) 

(Fully specified. Atari) 
(Fully specified, Amiga) 
(User's home directory, UNIX) 
(Relative directory) 

(Login (home) directory) 


The CD command applies only within Kermit itself and any programs that Kermit 
runs. When you EXIT from Kermit, you should find yourself back where you started. 
Synonyms: CWD (Change Working Directory), SET DEFAULT. 
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DELETE filespec 

Deletes (removes, erases, destroys) all files that match the filespec, which may contain 
wildcards, directory names, and/or device designators. Successful execution of this 
command requires that you have appropriate access rights to the specified file or files. 
UNIX examples: 

C-Kermit> delete oofa.txt (One file in current directory) 

C-Kermit> del * (All files in current directory) 

C-Kermit> del /usr/olaf/kermit/a.txt 

(Fully specified UNIX file) 


VMS and Open VMS examples: 

C-Kermit> delete oofa.txt;3 (One file in current directory) 

C-Kermit >del *.*;* (All files in current directory) 

C-Kermit >del $diskl;[olaf.kermit1 a.txt;7 

(Fully specified VMS file) 


Synonym: RM. 


DIRECTORY [ {filespec, directory-name } ] 

Lists files. If no filespec or directory name is given, lists all files in the current direc¬ 
tory. If a directory name is given, lists all files in the specified directory. If a filespec 
is given, lists all files that match it. Examples for UNIX: 


C-Kermit >directory 
C-Kermit> dir -olqa 
C-Kermit> dir -/kermit 
C-Kermit> dir kermit 
C-Kermit> dir ck*.* 
C-Kermit> dir .. 
C-Kermit>dir ../a*.* 


(List all files in current directory) 
(All files in olga's login directory) 
(All files in my kermit directory) 

(All files in kermit subdirectory) 
(Files whose names match) 

(All files in superior directory) 
(Matching files in superior directory) 


Corresponding VMS and Open VMS examples: 

C-Kermit> dir (List all files in current directory) 

C-Kermit> dir $disk:[olga] (All files in olga's login directory) 
C-Kermit> dir folqa.kermit1 (and in olga's kermit subdirectory) 
C-Kermit> dir [■kermit] (All files in my kermit subdirectory) 

C-Kermit> dir ck*.* (Files whose names match) 

C-Kermit> dir f-] (All files in superior directory) 

C-Kermit >dir f-]a*.* ("a" files in superior directory) 

Corresponding AOS/VS examples: 

C-Kermit> dir (List all files in current directory) 

C-Kermit> dir :udd;olga:+ (All files in olga's login directory) 
C-Kermit >dir ;uddsolga:kermit:+ (in olga's kermit subdirectory) 


C-Kermit> dir kermit :+ 
C-Kermit> dir ck+.+ 
C-Kermit>dir_2+ 
C-Kermit> dir *:a+ 

Synonym: LS. 


(All files in my kermit subdirectory) 
(Files whose names match) 

(All files in superior directory) 

("a" files in superior directory) 
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ECHO [ text ] 

Displays the text on the screen. The text may contain imbedded backslash codes to be 
interpreted. If the text is omitted, an empty line is displayed. Examples: 


C-Kermit >echo Good morning. 
Good morning. 

C-Kermit> echo \7Wake upl\7 
<BEEP>Wake up!<BEEP> 
C-Kermit> 


Comment won't echo 


Leading and trailing spaces are removed unless the text is enclosed in curly braces: 


C-Kermit> echo 

Testing 

C-Kermit> echo 

Testing 

C-Kermit> 


Testinc 


Testinc 


Synonym: WRITE SYS$OUTPUT. Related: WRITE SCREEN. 


HELP [ command ] 

Displays a help message. The command is a C-Kermit command, one or two words at 
most, such as comment, ECHO, or set duplex. Example: 

C-Kermit> help set duplex 
Syntax: SET DUPLEX { FULL, HALF } 

During CONNECT: FULL means remote host echoes, HALF means 
C-Kermit does its own echoing. 

C-Kermit> 

If you do not include any text after the word HELP, a brief overview is displayed. Use 
question mark to get menus within the HELP command. Synonym: MAN. 


PAUSE [ number=l ] 

This command tells Kermit to do nothing for the given number of seconds. The 
prompt returns after the time has expired or if you type something (any character) in 
the meantime. Examples: 

C-Kermit> pause (Pause for one second) 

C-Kermit> pau 30 (Pause for 30 seconds) 

Synonyms: WAIT (when used without modem signals), SLEEP. 

Related: MSLEEP. Like PAUSE, but number is in milliseconds. 


PRINT [ local-options ] filename 

Prints the local file on a local printer, if your computer has one. Local options can be 
included for your computer’s printing command. Examples: 


C-Kermit> print oofa.txt 
C-Kermit> print /copies=3 oofa.txt 
C-Kermit> print -#3 oofa.txt 
C-Kermit>print /copies=3 oofa.txt 


(Print a file) 

(VMS or OpenVMS options) 
(UNIX options) 

(AOS/VS options) 
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PUSH 

Invokes your system’s command processor “underneath” Kermit interactively in such 
a way that you can return to Kermit later. 

C-Kermit >push 

% 

% who ivan 

% watsunlivan ttyh9 Aug 11 14:21 

% write ivan ttyh9 

Hi there I 

Ctrl-D 

% exit 

C-Kermit> 

To return from the “inferior” command processor to C-Kermit, use the exit or 
Ctrl-D command in UNIX or OS-9, the EXIT command in OS/2, LOGOUT in VMS 
and Open VMS, POP in AOS/VS, endcli on the Amiga. Synonyms:!, <S), RUN. 

PWD 

pwd stands for Print Working Directory. It displays the name of your current default 
(working) directory. Examples: 

C-Kermit> pwd 
/usr/olga/letters 
$DISK1:[OLGA.LETTERS] 

:UDD:OLGA:LETTERS 
C:\OLGA 

Synonym: SHOW DEFAULT. 

RENAME filename1 filename2 

Changes the name of the file whose name is filename1 to filename2, for example: 
C-Kermit >ren space-adventure.exe spreadsheet.exe 

The ability of the rename command to operate across directories or devices depends 
on the capabilities of the underlying operating system. Synonym: MV. 

RUN [ command ] 

Runs the named system command or program and returns to the C-Kermit prompt 
automatically when the command or program is finished. If no command name is 
given, the RUN command is exactly like the PUSH command. Examples: 
C-Kermit> run fortune 

Who messed with my anti-paranoia shot? 

Synonyms: PUSH, !, Examples: 

C-Kermit> @show system 

C-Kermit> gsearch area-codes.txt Chicago 
C-Kermit> I date 

C-Kermit> lgrep Chicago area-codes.txt 
C-Kermit> 1 time 

C-Kermit> Ifind "Chicago" areacode.txt 


(VMS or OpenVMS) 
(VMS or OpenVMS) 
(UNIX or OS-9) 
(UNIX or OS-9) 
(AOS/VS) 

(OS/2) 


(UNIX, OS-9, or Amiga) 
(VMS or OpenVMS) 
(AOS/VS) 

(OS/2 or Atari ST) 


34 Running C-Kermit / Chapter 2 



SPACE [ device ] 

Displays information indicating how much space is available on the current or given 
disk device, or in the current directory, or remaining in your quota, depending on the 
operating system. 

TYPE filename 

Displays the contents of the file on the screen. The type command does not pause at 
the end of each screenful, like UNIX more or VMS type/page. If you need this ef¬ 
fect in UNIX, use lmore. In VMS, PUSH to DCL and use type/page instead. 


The C-Kermit Initialization File 


The initialization file is a command file that C-Kermit executes automatically when it 
starts. Its name and location depend on which type of computer system you have (see 
Table 2-3 on the next page), normally . kermrc (UNIX and OS-9) or ckermit.ini (all 
the others). 

The initialization file should contain the commands that you want to be executed every 
time you start the C-Kermit program. For example, if you have a UNIX workstation 
whose serial communication device is connected to a Hayes 2400 modem and you always 
use C-Kermit to dial out on this device, your initialization file, . kermrc, might contain 
commands like these: 

set modem hayes ; So DIAL command works right 

set line /dev/ttyb ; Use ttyb for communication 

set speed 2400 ; Modem's highest speed 

echo Ready for Hayes dialing at 2400 bps on /dev/ttyb. 
echo Remember to turn on your modem! 

(The SET commands are explained in the next chapter.) Note the use of trailing comments 
for documentation. With this initialization file, the only command you need to give Ker- 
mit to dial up another computer is dial (also explained in the next chapter): 

$ kermit (Start Kermit) 

Ready for Hayes dialing at 2400 bps on /dev/ttyb. 

Remember to turn on your modem! 

C-Kermit >show communications (Check effect of init file) 

Communications Parameters: 

Line: /dev/ttyb, speed: 2400, mode: local, modem: hayes 

C-Kermit> dial 9876543 (Dial another computer) 

Call completed. (So easy!) 

C-Kermit> (Kermit awaits your command) 

As you progress through this book, other likely candidates will suggest themselves for in¬ 
clusion in your “init” file—terminal settings (Chapter 4), file transfer protocol settings 
(Chapters 5-7), character-set selections (Chapter 9), macro definitions (Chapters 11-13). 


The C-Kermit Initialization File 35 




Table 2-3 C-Kermit Initialization File Name 


System 

File Name 

Remarks 

Atari ST 

CKERMIT.INI 

C-Kermit looks first in the current directory, then in 
your home directory, and finally in the root direc¬ 
tory. 

Commodore Amiga 

CKERMIT.INI 

C-Kermit looks first in the s: directory, then in the 
current directory. 

Data General AOS/VS 

CKERMIT.INI 

C-Kermit looks in your home directory. 

OS/2 

ckermit.ini 

C-Kermit checks the directories defined by the 

OS/2 environment variables INIT, PATH, and 
DPATH, in that order, and if the file is not found, 
then looks in the current directory. 

OS-9 

. kermrc 

C-Kermit looks in your home directory first, then in 
the current directory. 

UNIX (all versions) 

. kermrc 

Your home directory, period. 

VMS, OpenVMS 

CKERMIT.INI 

C-Kermit looks for CKERMIT_INI:CKERMIT. INI, 
then for the file defined by the symbol 
ckermit_init, and finally in your home direc¬ 
tory, SYS$LOGIN, forCKERMIT.INI. 


If you want Kermit to use a specific command file for initialization instead of the default 
command file shown in Table 2-3, you can specify an alternate initialization-file name on 
the command line, using the -y (lowercase) command-line option: 

$ kermit -y special.cmd 

If you want to run C-Kermit without any initialization file at all, use the -Y (uppercase) 
command-line option: 

$ kermit -Y (UNIX, OS/2, etc.) 

$ kermit "-Y" (VMS or OpenVMS, quotes required) 

If you want C-Kermit to execute a particular command file after it executes the initializa¬ 
tion file, but before it issues its first prompt, include the filename as the first word after 
kermit when you invoke C-Kermit from the system prompt: 

$ kermit tuesday.tak 

See the Appendix particular to your operating system for details about the initialization 
file, as well as Chapter 11 for further information about command files in general. 

We recommend that you use the standard initialization file, CKERMIT.INI, that is dis¬ 
tributed with C-Kermit 5A, and that you make any desired modifications or customiza- 
tions in the accompanying CKERMOD. INI file. 
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Chapter 3 


Getting Connected 


In Chapter 2 you learned how to operate C-Kermit within the safe and circumscribed en¬ 
vironment of a single computer, much like you would use most other computer software 
applications. But unlike those applications, the purpose of Kermit software is to let you 
use two computers at once, such as the PC on your desk and a large mainframe located 
elsewhere. 

Before we proceed, let’s refresh our memories about remote and local. A Kermit program 
is in local mode if you are using it to establish a connection to another computer. Other¬ 
wise, it is in remote mode. For example, if you are using an MS-DOS PC on your desk to 
access a remote UNIX computer where C-Kermit resides, you will be using MS-DOS 
Kermit in local mode and C-Kermit in remote mode , as illustrated in Figure 3-1 on the 
next page. The PC establishes the connection, so it’s the local computer. The UNIX sys¬ 
tem receives the connection, so it’s the remote computer. 

O O O O <- (Stepping stones) 

If you will be using C-Kermit only in remote mode, you don’t need to read this 
chapter or the next one. Skip ahead to Chapter 5, page 95, to learn how to trans¬ 
fer files. If necessary, also consult the “Getting Online” section of the docu¬ 
mentation for your local Kermit program, for example. Chapter 7 of Using 
MS-DOS Kermit [29], 

There are two ways to use C-Kermit in local mode, depending on what kind of computer 
you have. The first method is used when you have a workstation on your desk from which 
you establish a connection to a remote computer. Figure 3-2 shows your local computer 
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UNIX 



IBM Mainframe 



as a Sun SPARCstation, with a modem connection to a remote IBM mainframe. The 
workstation could be any UNIX or OS-9 workstation, a VAXstation, a PC with OS/2 or 
UNIX, an Amiga, or an Atari ST. Any of these computers could use C-Kermit to estab¬ 
lish the connection to the remote computer. 
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Connection 



MS-DOS Kermit in I—I 
LOCAL MODE P 


YOU ARE NOT HERE 


Modem j 
(DIAL) 


YOU ARE HERE 


Figure 3-3 C-Kermit in the Middle 


In the second scenario, illustrated in Figure 3-3, you are accessing a multiuser UNIX, 
VMS, Open VMS, or AOS/VS timesharing system from a PC, Macintosh, workstation, or 
terminal on your desk, and you are using C-Kermit on the multiuser computer to connect 
to a third computer. You would use this method if the multiuser computer has a connec¬ 
tion method not available to your desktop computer, or if the multiuser computer is where 
you do most of your work. 

Figure 3-3 shows an IBM PC with MS-DOS Kermit calling a VAX/VMS computer and 
using C-Kermit on the VAX to place a call to CompuServe. As you can see, you are using 
two communication ports on the VAX: the first for logging in and the second for dialing 
out. This illustrates how a local Kermit program uses a separate device, having nothing to 
do with your keyboard and screen, to communicate with the remote computer. 
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Using C-Kermit in Local Mode 

Local mode operation of C-Kermit has four phases: setting the appropriate communication 
parameters, making the connection, using the connection, and releasing the connection. 
The process can be easy or difficult, depending on your local computer, the connection 
method used, and the remote computer or service. C-Kermit is set up to handle the easy 
cases automatically, but the hard cases require a little extra effort. 

oooo 

This chapter assumes you are familiar with data communication concepts such 
as modem, null modem, speed, parity, cable, and connector. If you aren’t, 
please turn to Appendix II on page 359 for a tutorial. 

Before you can make two computers communicate, you have to learn certain essential 
facts about them and the connection between them. What is the connection method 
—dialup, direct, or network? For dialup and direct connections, what is the name of the 
communication device on the local computer and what speeds are permitted? For dialup 
connections, what type of dialout modem is on the local computer and what is the remote 
computer’s telephone number? Use C-Kermit’s SET command to supply these facts. 
C-Kermit tries to give you reasonable defaults; if your connection to the other computer 
fits the defaults, you need just a few SET commands and connecting is easy. 

A Test Drive 


To show you just how easy a connection can be, let’s use C-Kermit to dial the Digital 
Equipment Corporation Electronic Store. In this example, we’re running C-Kermit on a 
DEC UNIX workstation (DECstation) in a terminal window, which provides VT terminal 
emulation. We dial out using a Hayes Smartmodem 2400 at 2400 bits per second. This 
same example should work on practically any other computer where C-Kermit runs, but 
you probably will have to substitute a different device name in the SET LINE command, 
and possibly a different modem type. 

How do you know the name of the communication device? If you have a desktop 
workstation, look in your workstation’s user manual. Some sample workstation dialout 
device names are listed in Table 3-1, in which the modem is assumed to be attached to the 
first serial device on each computer. 8 If you are dialing out from a multiuser computer, 
you’ll have to consult your site-specific documentation or ask the system support staff. 
This demonstration is available only in the North American calling area, and it works only 
if C-Kermit is running in an environment that supports DEC VT100, VT200, VT300, or 


8 


If your workstation has a serial mouse, the modem might be attached to the second serial device. 
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Table 3-1 Sample Dialout Device Names 


System 

Default Device 

Dialout Device Name 

Apple A/UX 

console 

/dev/modem 

AmigaDOS 

serial.device/0 

serial.device/0 

Amiga UNIX 

console 

/dev/term/ser or/dev/term/ql00 

AT&T 6300 PLUS 

console 

/dev/ttyl 

AT&T 7300 UNIX PC 

console 

/dev/phO 

Atari ST GEMDOS 

AUXs 

AUX: 

Data General Aviion 

console 

/dev/tty00 

Data General AOS/VS 

console 

@conl 

DECstation ULTRIX 

console 

/dev/tty00 

Dell UNIX 

console 

/dev/tty01 (if mouse on /dev/tty00). 
For RTS/CTS, use /dev/tty01h. 

HP-9000 HP-UX 

console 

/dev/culdO 

IBM RS/6000 AIX 

console 

/dev/ttyO 

Interactive UNIX/386 

console 

/dev/ttyO or/dev/acuO 

NeXT 

console 

/dev/cua. Use/dev/cuf a for 

RTS/CTS. 

OS/2 

COMl 

COMl 

OS-9 

console 

/tl 

SCO UNIX 

console 

/dev/ttyl A (uppercase A selects modem 
control) 

SCO Xenix 

console 

/dev/ttyla 

Sun SPARCstation 

console 

/dev/cuaO or/dev/cual 

VMS, Open VMS 

console 

TXA0 :, TTA0 s, or LTA0 s 


higher VT terminal emulation, such as a true VT terminal or emulator connected to the 
system where C-Kermit is running, a DECterm or xterm window on a workstation, the 
console driver on a PC-based UNIX system, or you are using OS/2 C-Kermit, which 
provides its own VT100 emulation. 


$ kermit 

C-Kermit 5A(188), 23 Nov 92, 
Type ? or HELP for help 
C-Kermit> set modem hayes 
C-Kermit> set line /dev/cuaO 
C-Kermit> set speed 2400 
C-Kermit> dial 1-800-234-1998 
Dialing 1-800-234-1998 
Device=/dev/cuaO, modem=hayes 
Call completed.<BEEP> 


(Start Kermit on the DECstation) 
ULTRIX 4.2 

(What kind of modem you have) 
(Communication device to use) 
(Dialing speed) 

(Place the call) 

(Messages from C-Kermit...) 
speed=2400 
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C-Kermit> connect (Make the connection) 

Connecting to /dev/cua, speed 2400. 

The escape character is Ctrl-\ (ASCII 28, FS). 

Type the escape character followed by C to get back, 
or followed by ? to see other options. 

Welcome to Digital's Electronic Store. Please wait a moment ... 

(Follow the directions, 
browse around for a while, and then...) 

To get back to C-Kermit at any time after connecting to the remote service, type 
Ctrl-Backslash and then the letter C. That is, hold down the Ctrl (or Control) key and press 
the backslash key, 9 then let go of the control key and press the C key. 

Ctrl-\C (Escape back to C-Kermit) 

C-Kermit >exit (All done, exit to UNIX) 

$ 

Wasn’t that easy? Here’s hoping that all your connections are so easy! In this case, all 
you had to do was tell C-Kermit what kind of modem to use, the name of the communica¬ 
tion device that the modem was connected to, and the speed to use for dialing. Then you 
dialed the phone number, connected, did some window shopping, got back to C-Kermit, 
and then returned to your operating system. 

Establishing a Serial Connection 

The rest of this chapter discusses C-Kermit’s different methods for connection establish¬ 
ment: direct connections, dialout modem connections, and network connections. Terminal 
connection is covered in Chapter 4. 

oooo 

If you will not be making serial connections, but you will be making network 
connections, please skip ahead to page 67. 

A serial connection is made over an asynchronous serial communication device, also 
called a serial port, terminal port, tty port, RS-232 port, V.24 device, EIA port, 
asynchronous adapter, or internal modem. If the port is connected directly to another 
computer, which would normally be done with a null modem cable, the connection is 
direct. If it is connected to a modem that is, in turn, connected to a telephone line that 
must be dialed, the connection is dialed. 


9 On the NeXT workstation, substitute the right bracket key for the backslash key. Most NeXT keyboards 
do not support the Control-Backslash key combination. On PCs running OS/2, use either Control- 
Rightbracket or Alt-X (hold down the Alt key and press the X key). 
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Selecting the Communication Device 

For any type of serial connection, you must tell Kermit the name of the serial device. The 
SET line command opens a serial communication device so you can use it: 

SET LINE [device] 

Opens the serial communication device through which you will be communicating. If 
you give the set line command without including a device name, C-Kermit closes 
any currently open communication device and returns to the default communication 
device, which in most cases is your controlling terminal ( console ) and remote mode, 
or to the default dialout device, as shown in Table 3-1. Synonym: SET PORT. 
Examples: 

(UNIX) 

(VMS or OpenVMS) 

(AOS/VS) 

(OS/2) 

(OS/2, same as line com2) 
(OS/2, same as line 2) 

(All, default device) 

Whenever you give a set line command, C-Kermit closes any currently open communi¬ 
cation device before attempting to open the new one. The set line command can fail for 
any of the following reasons, which are printed as error messages on your screen: 

Sorry, access to device denied 

The communication device is protected against you. Contact your system administra¬ 
tor to see if you can get the required access. 

Sorry, access to lock denied 

(UNIX only) The lock mechanism that prevents more than one person from using the 
same communication device at the same time is protected against you. Contact your 
system administrator. 

Sorry, device is in use 

Somebody else is currently using the communication device you have specified. If 
you get the “device is in use” message in UNIX, C-Kermit attempts to show you who 
is using it: 

C-Kermit> set line /dev/ttyh8 

-r—r—r— 1 olga 11 Feb 24 15:17 /var/spool/locks/LCK..ttyh8 

pid = 15688 

/dev/ttyh8: Sorry, device is in use 
C-Kermit> 

The first line is a directory listing of the lock file showing who created it (Olga). The 
“pid” is the process ID of the program that created the lockfile. If you know where 
Olga is, you can ask her when she will be finished with the device you need. 


C-Kermit >set line /dev/cua 
C-Kermit >set line txa4: 
C-Kermit >set line 8con2: 
C-Kermit >set line com2 
C-Kermit >set line 2 
C-Kermit >set port 2 
C-Kermit>set line 
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Sorry, can’t open connection 

Kermit encountered some other kind of error or difficulty when trying to open the 
device. The appropriate system error message is also printed, for example: 

No such file or directory 

Timed out, no carrier 

You have given a SET carrier ON command (see page 46) that specified a time limit 
for set line to wait for carrier, but carrier did not appear within the time limit. 

If a SET line command appears to be stuck, it means that the operating system is having 
difficulty opening the device. You should be able to get back to the C-Kermit prompt by 
typing Ctrl-C. 

If a new prompt appears and there is no error message, C-Kermit has opened the serial 
communication device successfully. 

Specifying the Communication Speed 

Before using the serial communication device that you specified in your SET line com¬ 
mand, you should select the transmission speed. This should be the same speed as the 
remote computer or service uses. Two serial devices can’t communicate at all if they are 
not using the same speed. 

SET SPEED number 

Specifies the transmission speed, in bits per second, to use on the serial communica¬ 
tion device specified in your most recent SET LINE command. If you don’t give a SET 
SPEED command, Kermit tries to learn the device’s current speed and use it. Only cer¬ 
tain speeds are available; type SET SPEED ? to find out what they are. The list can vary 
from computer to computer. Here is a typical example: 

C-Kermit> set speed ? 

Transmission rate in bits per second, one of the following: 


110 

1200 

150 

19200 

200 

2400 

300 

3600 

38400 

4800 

50 

600 

75 

75/1200 

9600 



C-Kermit>set speed 2400 
C-Kermit> 

Notice that the speeds are arranged in “alphabetical” rather than numeric order. Because 
they are keywords, you can use abbreviation and completion with them, and you cannot 
enter an illegal value by mistake. Examples: 

C-Kermit> set speed 9600 (9600 bits per second) 

C-Kermit> set sp 9 (9600 bits per second) 

C-Kermit> set sp 9500 (Not in the list) 

?No keywords match - 9500 
C-Kermit> 


44 Getting Connected / Chapter 3 



The 75/1200 entry is for use with split-speed modems, found mostly in Europe. Split 
speed operation is supported only in C-Kermit versions where the underlying computer 
operating system and hardware also support it. 75/1200 means C-Kermit transmits at 75 
bps and receives at 1200 bps. 

Remember, SET SPEED applies to the device given in the most recent SET LINE command. 
Kermit must know which device’s speed you are setting. So the rule is: SET LINE first, 
then SET SPEED. 

You can’t use C-Kermit’s set speed command to change your login terminal’s speed. If 
you issue the SET SPEED command while Kermit is in remote mode, you’ll get an error 
message: 

C-Kermit> set speed 2400 
?Sorry, you must SET LINE first 

Hanging up the Connection 

To terminate a connection, use the hangup command: 

HANGUP 

Breaks the connection. If you have given a SET MODEM command, the HANGUP com¬ 
mand attempts to put your modem in command mode and then issue the modem’s 
hangup command, for example ATH0 for Hayes modems. If this does not work, or if 
you have not given a SET MODEM command, C-Kermit attempts to lower the Data Ter¬ 
minal Ready (DTR) signal for about half a second. 

On a dialed modem connection, HANGUP should cause the modem to terminate (hang up) 
the telephone, which should, in turn, cause the remote computer or service to terminate 
your session if it is still in progress. A properly wired direct connection should simulate 
these same actions. 

Normally, the hangup command need not be used. When you log out from a remote 
computer or service, it hangs up its end of the connection, and C-Kermit should automati¬ 
cally pop back to its prompt. Use the hangup command in situations where this does not 
happen, or when you want to be sure that the connection is broken. 

The Carrier Signal 

Serial communication devices might not allow themselves to be opened if the software 
and hardware don’t agree about the RS-232 Carrier Detect (CD) signal, a signal from the 
modem to the computer (see Appendix II). 

Most versions of C-Kermit assume that CD is off during dialing, that it is on when the 
connection has been made and is in use, and that it goes off again when the connection is 
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broken. But your modem might be configured to keep carrier on (or off) all the time, or 
the cable connecting the modem to your serial port might not convey the carrier signal 
correctly. The SET carrier command lets you adjust Kermit to such situations: 

SET CARRIER { AUTO, OFF, ON [ number ] } 

Successful operation of SET CARRIER is highly dependent on the capabilities of your 
operating system and version, and Kermit’s knowledge of them, as well as the configura¬ 
tion of your serial port, modem, and cable. The set carrier command takes effect on the 
next SET LINE command. Thus you should SET CARRIER first, then SET line. Here are the 
set carrier options: 

SET CARRIER AUTO 

Requires carrier during CONNECT but not at other times. AUTO is the default. 

SET CARRIER OFF 

C-Kermit is to ignore carrier at all times. This option is useful for direct connections, 
misbehaving modem connections, miswired or misconfigured modems, or buggy 
serial device drivers. It should be used only when necessary because it takes away 
Kermit’s ability to automatically detect a broken connection. 

SET CARRIER ON [ number ] 

C-Kermit is to require carrier for all communication. An error is diagnosed if carrier 
disappears during CONNECT or file transfer, and C-Kermit should give an error mes¬ 
sage and pop back to its prompt automatically. When SET carrier on is in effect, CD 
must be present when you give the SET LINE command. If it is not, Kermit waits for 
the carrier signal to appear. This allows the SET LINE command to wait for an incom¬ 
ing telephone call. 

If you want to set a limit on how long set line should wait for carrier, you can include 
an optional number after set carrier ON that indicates how many seconds to wait be¬ 
fore timing out and returning to the prompt, for example: 

C-Kermit> SET CARRIER ON 30 

You can also type Ctrl-C to interrupt a SET LINE command that is taking too long. In 
both cases (timeout and Ctrl-C interruption), the device is not successfully assigned. 

Flow Control 

Flow control is the process by which one computer (or other device) can request another 
computer (or device) to stop sending data, allowing time for the data received so far to be 
processed, and then request it to start sending again. Flow control is especially important 
to Kermit during file transfer operations and is covered in greater detail in Chapter 6. 
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Row control prevents buffer overflows and data loss, if it is used effectively, meaning the 
computers or devices on each end of the connection must be configured to use the same 
type of flow control. There are two major types of flow control, software and hardware. 
Software flow control, also called Xon/Xoff flow control, is accomplished by inserting 
special control characters, Ctrl-S (Xoff) and Ctrl-Q (Xon), into the transmitted data. Xoff 
means stop sending and Xon means resume sending. Software flow control is generally 
used end-to-end, that is, between the computers at the two ends of the connection, rather 
than between a computer and the device it is immediately connected to. 

Hardware flow control generally occurs between a computer and the communication 
device (modem, terminal server) directly connected to it. It uses separate wires in the 
cable, usually the RTS and CTS circuits. Hardware flow control should be used whenever 
available, because it is far more effective than software flow control. The flow control 
signals take effect immediately and are not subject to loss or corruption. 

The C-Kermit command to select the flow control method is: 

SET FLOW-CONTROL { KEEP, NONE, RTS/CTS, XON/XOFF } 

The options are: 

KEEP 

Use whatever type of flow control the device was configured with at the time that 
C-Kermit first opened it. 

NONE 

Don’t use any method of serial-connection flow control. Use this option when the two 
computers or devices do not share a flow control method in common, or when the two 
computers or devices are both so fast they don’t need to use flow control, or when the 
connection is not serial at all, for example a TCP/IP network connection, in which 
case the underlying network protocol provides the flow control. 

RTS/CTS 

Hardware flow control using the RTS and CTS RS-232 signals. This option is not 
available in all versions of C-Kermit because certain operating systems do not support 
it. If it is available, it will show up in the keyword menu if you type “set flow ?”. 
Use this option with high-speed modems, terminal servers, or other devices that also 
support it, and on direct serial connections when the two serial devices and their driver 
software also support it, and when the null modem cable is properly wired to convey 
these signals (Model B in Figure II-6, Appendix II, page 372). 

XON/XOFF 

Software flow control using Ctrl-S and Ctrl-Q. Use this method when both end sys¬ 
tems support it and RTS/CTS is not available. This method is effective only on full 
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duplex connections and should not be used on half duplex (local echo) connections. 
XON/XOFF is the default flow control method, so be sure to SET flow none if you are 
making a half duplex connection. 


RTS/CTS flow control is sometimes available to you even when C-Kermit’s SET FLOW 
command does not offer it. For example, in certain UNIX systems, such as a NeXT 
workstation, or Dell UNIX, it can be selected by using special device names (see Table 
3-1 on page 41). On other systems it can be enabled by giving a system command before 
starting C-Kermit, for example: 

% stty crtscts 
on certain UNIX systems, or: 

) characteristics /on/ifc/ofc 

in AOS/VS. Consult your system documentation for further information. 

Certain versions of C-Kermit might also support less common hardware flow-control op¬ 
tions, such as DTR/CD or dtr/cts. If your version of C-Kermit, and the underlying device 
and driver software, and the directly connected communication device, support these op¬ 
tions, then you can use them in place of RTS/CTS. Use them with caution, however; the 
CD signal normally tells C-Kermit the connection is broken, so you should SET CARRIER 
OFF before attempting to use DTR/CD flow control. Also, when using either DTR/CD or 
DTR/CTS, make sure your communication device is configured not to hang up the con¬ 
nection if your computer turns off the DTR signal! 


Displaying Communication Settings 

To find out your current communication device, speed, carrier, flow control, and other set¬ 
tings, use the SHOW COMMUNICATIONS command, as in this example for UNIX: 

C-Kermit >show comm 

Line: /dev/ttyh8, speed: 9600, mode: local, modem: direct 
Terminal bits: 7, parity: none, duplex: full, flow: xon/xoff 
Carrier: auto, lockfile: /var/spool/locks/LCK.,ttyh8 
Escape character: 28 ( A \) 

C-Kermit> 


Direct Serial Connections 


Figure 3-4 shows a direct serial connection from a DEC VAXstation to a remote computer 
using a null modem cable. The VAXstation could also be any other kind of computer 
where you are running C-Kermit in local mode. This kind of connection is relatively easy 
to use because no modems are involved and dialing is not required. All you have to do is 
tell C-Kermit the name of the communication device that the cable is connected to and the 
communication speed to use. The other end of the cable should be connected to a port on 
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DEC VAXstation 


Remote Computer 
or Terminal Server 



Figure 3-4 A Direct Connection 


the remote computer that has been set up to let you log in. The remote computer in the 
figure also can be a terminal server or similar device with which you have a brief dialog to 
select a computer or service and which then connects you to it. 

The only commands C-Kermit should need to establish a direct connection are SET LINE 
and SET SPEED. Here is an example of setting C-Kermit up for a local-mode direct con¬ 
nection, showing the order in which you should give the commands: 

C-Kermit> set speed 9600 (Set the speed) 

?Sorry, you must SET LINE first (Oops) 

C-Kermit >set line txa5 (Select communication device) 

C-Kermit >set speed 9600 (Now set the speed) 

C-Kermit> (No complaint) 

If you have trouble establishing a direct connection: 

• Make sure the port on the remote computer is set up to allow logins (or it is a port on a 
PC or workstation controlled by a Kermit server). 

• Make sure the serial devices on the two computers are configured to use the same 
communication speed. 

• Make sure you have used a null modem cable rather than a modem cable (see Figure 
II-6 on page 372), and that each computer’s serial port asserts the DTR signal and 
receives all the signals it requires, usually DSR, CTS, and CD. 

• Make sure the total length of the cable does not exceed 15 meters or 50 feet. For 
direct connections over longer distances, use powered line drivers or limited distance 
modems (LDMs) at each end of the cable, or use a shielded low-capacitance cable. 

• Try SET CARRIER off before SET LINE. 
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REMEMBER: SET CARRIER first (only if necessary), then SET LINE, then SET SPEED. In 
that order. 

If your direct connection is wired with a true null modem cable (such as the one shown in 
Figure II-6, Model B), Kermit should notice when the remote computer crashes or when 
you log out from it, and return you automatically to the local C-Kermit prompt with a 
message like “communications disconnect”. If you have used a “fakeout” cable (like 
Model A in the figure), Kermit does not notice, and the connection remains open. 

oooo 

The rest of this chapter tells how to make dialed and network connections. If 
you will not be making dialed connections, but you will be making network con¬ 
nections, turn to page 67 in this chapter. If you will not be making dialed or net¬ 
work connections, turn to Chapter 4 to learn how to make a terminal connection. 

Dialed Serial Connections 


When you can’t connect two computers with a direct cable (or with a network), you can 
do it with modems and the telephone system, as illustrated in Figure 3-5. With C-Kermit 
and an appropriate modem, your computer can call any computer or data service in the 
world that accepts modem calls and has a modem compatible with yours. C-Kermit sends 
dialing commands to the modem, the modem places the call and tells Kermit whether it 
was answered, and Kermit tells you whether the call was placed successfully. 
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Let’s demonstrate the simple steps that should work in most situations. Find out what 
kind of modem you will be dialing with, the name of the communication device it is at¬ 
tached to, the phone number of the computer or service you will be dialing, and the speed 
at which its modem answers calls (you should dial at the same speed). Follow this ex¬ 
ample, substituting your own particulars for the ones shown, but issue the given com¬ 
mands in exactly this order: 10 

C-Kermit >set modem telebit (Identify the modem type) 

C-Kermit> set line /dev/cua (Identify the communication device) 

C-Kermit >set speed 2400 (Select the dialing speed) 

C-Kermit> dial 93,1-800-555-1234 (Dial the phone number) 

REMEMBER: SET MODEM first, SET line second, SET SPEED third, and then dial. 

NOTE: A different technique is used for dialing a modem that is connected to a TCP/IP 
modem server. It is described on p. 74 in the network section of this chapter. 

The SET MODEM Command 

The SET MODEM command lets you tell C-Kermit whether you will be using a modem, and 
if so, which dialing language it uses. 

SET MODEM [ fype=NONE ] 

If you are dialing out with an autodial modem, you must specify which type of modem 
is to be used so Kermit will know what kinds of commands to give it and how to read 
its responses. You must give the SET MODEM command before you open the commun¬ 
ication device so the operating system doesn’t block waiting for the CD signal when 
trying to open the device. 

There are three categories of modem types: 

NONE (or DIRECT) 

This is the default modem type. Use NONE when there is no modem and therefore 
no modem signals and no dialing, as on a directly wired connection, or to cancel a 
previously established modem type. Examples: 

C-Kenait> set modem none (Direct connection) 

C-Kermit >set modem direct (Same as above) 

C-Kermit> set modem (Same as above) 

CCITT, HAYES, TELEBIT, ... 

If you name a specific type of modem, Kermit uses its built-in knowledge of the dial¬ 
ing language and conventions for that modem when you issue a dial command, and it 
declares the connection complete or failed based upon responses from the modem. 


10 All telephone numbers shown in this book are fictitious unless noted otherwise. 
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The modems known to C-Kermit are listed in Table 3-2. In case new modems have 
been added since this book was printed, type SET MODEM ? to see an up-to-date list, for 
example: 

C-Kermit> set modem ? (See what's available) 

attdtdm attisn attmodem att7300 

ccitt-v25bis cermetek concord df03-ac 

dflOO-series df200-series direct gendatacomm 

hayes Many more... 

C-Kermit>set modem hayes (Hayes Smartmodem) 

IMPORTANT: The modem type is not necessarily the same as the modem brand. For 
example, if you have a Microcom modem that is configured to use the Hayes com¬ 
mand set rather than the Microcom-specific command set, you should SET MODEM 
HAYES rather than SET modem MICROCOM. Most modem modems are (or can be con¬ 
figured to be) “Hayes compatible.” So if your modem is not listed or if dialing with a 
non-Hayes modem does not work, try SET MODEM HAYES. 

UNKNOWN 

This means that there is a modem, but it is of a type unknown to C-Kermit (or to you). 
You must specify the modem’s entire dialing sequence in C-Kermit’s dial command. 
Modem signals are ignored while dialing, but Kermit, after dialing, waits for the CD 
signal to indicate the call was completed. Example: 

C-Kermit >set modem unknown 
C-Kermit >dial ATDT7654321 

If your computer has a type of modem that is not directly supported by C-Kermit, you still 
have ways to dial: 

1. SET MODEM unknown and specify the complete dialing string in your dial command. 

2. Dial manually. SET CARRIER OFF, then CONNECT, then interact with the modem 
directly, typing the dialing commands and monitoring the result codes (see p. 65 for 
details). 

3. Write a script program to dial your modem. Script programming is explained in Chap¬ 
ters 11-13. 

4. If you are a C programmer, modify the module ckudia. c to include support for 
your modem (and send the code back to Columbia University). 

Having selected a modem type, you can set line and set speed in the normal way. If the 
set line command succeeds, the DTR signal of the computer’s communication device is 
turned on to enable communication with the modem. If set line fails, you’ll get an infor¬ 
mative error message (see page 43 for a list of them). Set the communication speed to the 
highest speed supported by both modems, and select RTS/CTS hardware flow control if it 
is available, as in the example on page 54. 
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Table 3-2 Modem Types Known to C-Kermit 


Name 

Description 

ATTDTDM 

AT&T Digital Terminal Data Module 

ATTISN 

AT&T ISN Network 

ATTMODEM 

AT&T switched network modems 

ATT7300 

AT&T 7300 UNIX PC (3B1) internal modem 

ccirr 

ccrrr V.25bw-compliant modem 

CERMETEK 

Cermetek Info-Mate 212A 

CONCORD 

Concord Condor CDS 220 2400b 

DF03-AC 

DEC DF03-AC 

DF100-SERIES 

DEC DF100 Series 

DF200-SERIES 

DEC DF200 Series 

DIGITEL-DT22 

Digitel DT-22 (Brazil) 

DIRECT 

No modem at all, direct connection (= NONE) 

GENDATACOMM 

General Datacomm 212A/ED 

HAYES 

Hayes Smartmodem 1200, 2400,9600, compatible, or Rolm 244PC 

HST-COURIER 

Courier lOPitchBT-Roman HST modems 

MICROCOM 

Microcom modems in native (SX) mode 

NONE 

No modem at all, direct connection (= DIRECT) 

PENRIL 

Penril modems 

PEP-TELEBIT 

Telebit modem insisting on PEP protocol 

RACALVADIC 

Racal Vadic (Racal Milgo) modems 

ROLM 

IBM/Rolm 8000, 9000, or 9751 CBX DCM 

SLOW-TELEBIT 

Telebit modem with PEP, MNP, etc, disabled 

TELEBIT 

Telebit modem allowing PEP, Bell, or CC1TT protocols 

UNKNOWN 

Unknown (generic) modem type 

USROBOTICS-212 A 

US Robotics 212A 

V32-TELEBIT 

Telebit dialing in V.32 mode 

V42-TELEBIT 

Telebit dialing in V.42 mode 

VENTEL 

Ventel modems 
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C-Kermit> set modem telebit 
C-Kermit> set line /dev/cua 
C-Kermit> set speed 38400 
C-Kermit>set flow rts/cts 


(Modem type) 

(Device) 

(Speed) 

(Flow control) 


The DIAL and REDIAL Commands 

At last, you are ready to dial. C-Kermit’s dial command dials the given number, and the 
redial command dials the previous number again. 

DIAL dial-string 

Dials the given telephone number using C-Kermit’s built-in method for operating the 
type of modem you identified in your last SET MODEM command. If a particular 
modem type is set, just include the phone number and C-Kermit issues the appropriate 
dialing instructions and reads the responses: 

C-Kermit> dial 7654321 

If no modem type is set, this command gives an error message (“Sorry, you must SET 
MODEM first”). If the modem type is UNKNOWN, you must include the modem’s dial¬ 
ing command in the phone number, for example: 

C-Kermit >dial at&cldp7654321 

The dial-string is a telephone number or access code expressed in the syntax of your 
telephone system or PBX, possibly with other characters added that are meaningful to the 
modem. Example: 

C-Kermit> dial T 93,1 (212) 555-4321 

In this example, the modem is a Hayes or compatible, which ignores parentheses, spaces, 
and hyphens, so these may be included for clarity. The T tells the Hayes modem to use 
Tone dialing, 11 93 is a PBX code to get an outside line, the comma is a Hayes command 
to allow time for the secondary dialtone to appear, and the 1 requests a long distance call 
(in the North American dialing region). Consult Table II-2 on page 366 for details about 
the special characters allowed in Hayes modem dial strings, or read your modem manual. 

REDIAL 

Dial the number specified in your most recent dial command again. Example: 

C-Kermit> dial 7654321 (Dial the number) 

Failed ("BUSY") (Get a busy signal) 

C-Kermit> redial (A few minutes later...) 

Repeat as needed. 


1 ’Rather than Pulse dialing. C-Kermit does not tell Hayes modems which type of dialing to use, but 
instead lets the modem dial using its normal dialing method. You only need to insert a T or P here to 
override the modem’s normal behavior, or for Hayes-like devices that actually require the T or P in the 
dialing command, such as the Rolm 244PC. 
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A DIAL Example 

Here is an example of normal, problem-free, straightforward dialing, using a Hayes 
modem attached to a UNIX computer’s ttyh4 device: 

C-Kermit> set modem hayes (Set the modem type) 

C-Kermit >set line /dev/ttyh4 (Then open the serial device) 

C-Kermit> set speed 2400 (Set the speed for dialing) 

C-Kermit> dial 765-4321 (Dial the number) 

Dialing 765-4321 

Device=/dev/ttyh4, modem=hayes, speed=2400 

The timeout for completing the call is 64 seconds. 

To cancel: type your interrupt character (normally Ctrl-C). 

Call completed. 

C-Kermit> 


The Dialing Directory 

If you don’t want to remember (or type) lots of long telephone numbers, you can store 
your frequently called numbers in a dialing directory, a plain-text file containing entries of 
the form: 

name number speed parity comments 

Create the dialing directory file using your system’s CREATE command, or a text editor or 
word processor (be sure to save it in ASCII or plain-text format). 

To use the dialing directory, first tell C-Kermit the name of your dialing directory file: 

SET DIAL DIRECTORY [filename] 

Specifies the name of the dialing directory file. If C-Kermit can find the file and has 
read access to it, it is opened and kept open until you exit from C-Kermit or give a 
subsequent set dial directory command. If the filename is omitted, any currently 
open dialing directory file is closed. Examples: 

C-Kermit >set dial directory -/.kdd (UNIX or OS/9) 

C-Kermit >set dial dir c:/ckermit/ckermit.kdd (OS/2) 

C-Kermit >set dial dir ckermit.kdd (Current directory) 
C-Kermit >set dial dir (Close directory file) 

Now, whenever you give a DIAL command, C-Kermit tries to match your dial-string with 
a name in the file. When there is a match, the associated number is substituted and your 
speed and parity settings are changed automatically if they are specified in the dialing 
directory entry. If the dial-string is not found in the directory, it is used exactly as given. 

The dialing directory fields are separated by one or more spaces or tabs. A field can in¬ 
clude spaces if it is surrounded by curly braces. Trailing fields after the number field can 
be omitted, in which case the corresponding settings are not changed. The comments, of 
course, are optional. You can put an = sign in a particular speed or parity field to leave it 
unchanged. This format is compatible with the MS-DOS Kermit dialing directory. Here 
is a sample (all numbers are fictitious except the DIGITAL Store): 
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sprintnet 

7654321 

2400 

mark 


oofanet 

6543210 

1200 

odd 

This entry has a comment 

tymnet 

93,876-5432 

2400 

even 

Punctuation allowed 

decstore 

1-800-2341998 

2400 

none 

The DIGITAL Store 

hometone 

T5551212 

1200 

none 

T forces Hayes tone dialing 

homepulse 

P5551212 

1200 

none 

P forces Hayes pulse dialing 

home 

5551212 

1200 

none 

Default dialing method 

anyspeed 

999-9999 

= 

none 

Use current speed 

anyparity 

888-8888 

9600 

= 

Use current parity 

whocares 

777-7777 

= 

= 

Use current speed and parity 

{my sun} 
defaults 

{987 6543} 
987-6543 

2400 

none 

With word grouping 


Words may be entered in the directory, and in the dial command itself, in any combina¬ 
tion of uppercase and lowercase. 


You can abbreviate the name in your dial command; C-Kermit searches for an exact (but 
case-independent) match, and uses it if found. Otherwise, the directory is searched from 
top to bottom and the first entry that matches your abbreviation is used. So for example, 
dial D would dial the DIGITAL Store, dial h would dial the hometone number, and 
DIAL HOME would dial the HOME number. Assuming the file is called CKERMIT.KDD (KDD 
means Kermit Dialing Directory), and it is in the current directory, it can be used like this: 


C-Kermit >set dial dir ckermit.kdd 
C-Kermit >dial hometone 
C-Kermit >dial HOMETONE 
C-Kermit> dial sprint 
C-Kermit >dial my sun 
C-Kermit>dial 8765432 


(Specify the directory file) 
(Use name instead of number) 
(Case doesn't matter) 
(Abbreviations are OK) 

(A two-word entry) 

(A number not in the directory) 


If you have a dialing directory file, you can put a SET dial directory command for it in 
your C-Kermit initialization file so you don’t have to type this command every time you 
run C-Kermit, for example: 12 

set dial directory \v(home)ckermit.kdd 


The notation \v(home) means “my home directory.” It is explained in Chapter 11, but 
there is no need to read ahead—just use it. It lets C-Kermit find your dialing directory 
file, no matter what your current directory is. Of course, you can also give a system- 
specific file specification, and you can use different filenames: 

set dial directory -olga/.kdd 

set dial directory /usr/olga/my-dialing-directory 
set dial directory $diskl:[olga]ckermit.kdd 
set dial directory :udd:olgasolga.kdd 


12 The standard C-Kermit initialization file already includes a command like this. 
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but then your initialization file won’t be portable among UNIX, VMS, OpenVMS, 
AOS/VS, OS/2, and so on. 

C-Kermit also supports a more sophisticated services directory, which not only dials a 
particular number, but also logs you in to the host or service of your choice automatically. 
The services directory is explained in Chapters 11 through 13. 

The Finer Points of Dialing 

oooo 

If dialing works for you with what you have learned so far, there is no need to 
read anything further about serial connections. Skip ahead to Network Connec¬ 
tions on page 67 (if you plan to use them), or go directly to Chapter 4 to learn 
about terminal connection. 

When you encounter problems with dialing, C-Kermit has some commands that can help 
you diagnose and overcome them. Use the SHOW DIAL command first. It gives you a 
quick summary of all the settings that are likely to affect dialing, including the current 
LINE, MODEM, and SPEED values: 

C-Kermit >set modem telebit (First select a modem type) 

C-Kermit >set line /dev/cua (Then a serial device) 

C-Kermit >set speed 2400 (Then the speed) 

C-Kermit >show dial (Now let's take a look...) 

Line: /dev/cua, modem: telebit, speed: 2400 
Dial directory: (none) 

Dial hangup: on, dial timeout: auto 
Dial kermit-spoof: off, dial display: on 
Dial speed-matching: off, dial mnp-enable: off 
Dial init-string: ATF1M1Q4X3S2=43\{13> 

Redial number: none 
Carrier: auto 
/dev/ttyh8 modem signals: 


Carrier Detect 

(CD): 

Off 

Dataset Ready 

(DSR): 

On 

Clear To Send 

(CTS): 

On 

Ring Indicator 

(RI): 

Off 

Data Terminal Ready 

(DTR): 

On 

Request to Send 

(RTS): 

On 


C-Kermit> 

This is the first place to look for something obviously wrong: wrong line, wrong speed, 
wrong modem type. If any of these are incorrect, use set commands to fix them and try 
dialing again (hint: use the redial command). 

If dialing still doesn’t work, we’ll have to dig deeper. The next command to use is SET 
dial display on. It doesn’t fix anything, but it lets you watch what goes on between 
Kermit and the modem and might give you an idea of what needs to be changed. 
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SET DIAL DISPLAY [ { OFF, ON } ] 

Tells whether C-Kermit should display its dialog with the modem on your screen 
during the dialing process. Normally DIAL DISPLAY is off. When it is ON, you can 
watch Kermit’s commands to the modem and the modem’s responses, except that 
characters ignored by C-Kermit are not displayed. 


Let’s continue our example with the Telebit modem. We have already set modem, set 
line, and SET SPEED. Now let’s watch a successful dial command in action: 


C-Kermit >set dial display on 
C-Kermit>dial T741-8100 


(Watch dialing actions) 
(Dial the number) 


Dialing T741-8100 
Device=/dev/cua, modem=telebit, speed=2400 
The timeout for completing the call is 69 seconds. 

To cancel: type your interrupt character (normally Ctrl-C). 
Hangup OK 
ATF1M1Q4X3S2=43 
OK 

ATS48=1 S51=255 S52=2 S54=2 ATS7=69 S58=0 
OK 

S55=0 S66=0 S68=255 S95=0 ATS50=0 S110=0 
OK 

ATDT741-8100 
CONNECT 1200 
Speed changed to 1200 
Call completed. 

C-Kermit> 


(Kermit sends) 
(Modem responds) 
(Kermit sends) 
(Modem responds) 
(Kermit sends) 
(Modem responds) 
(Kermit sends) 
(Modem responds) 
(Kermit message) 
(Kermit message) 
(Prompt returns) 


There are many items of interest here, each of which can affect the success of the DIAL 
command. Kermit tells us that it will allow 69 seconds for the call to be completed. If the 
modem has not responded by that time, Kermit closes the call and gives an error message: 
Timed out. What if more time is needed? 


SET DIAL TIMEOUT number 

When you give a DIAL command, C-Kermit waits a certain number of seconds for a 
report from the modem telling whether the call succeeded or failed. The time limit is 
computed automatically based on the communication speed, the length of the phone 
number, the type of modem, and other factors. In some cases, the timeout might not 
be long enough, for example for an international call or for an advanced type of 
modem that must go through protracted negotiations with a different type of remote 
modem. Use this command to make Kermit skip its dial timeout calculation and use 
your value instead. Example: 

C-Kermit> set dial timeout 200 (200 seconds) 

When you have set modem to HAYES or one of the telebit models, C-Kermit also sets 
modem switch S7 (see Table II-2 on page 366) correspondingly, so the modem waits at 
least as long as C-Kermit does for the call to be completed. 
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The message “Hangup OK” means that Kermit hung up the phone connection as a first 
step. This ensures that the modem is in command mode rather than online mode from a 
previous connection; otherwise, the modem might totally ignore Kermit’s dialing com¬ 
mands. Unfortunately, this seemingly proper and innocent measure can sometimes result 
in unwanted problems caused by improper configuration or wiring, or by the inability of 
the underlying operating system to handle the hangup request correctly, in which case you 
will see a “Hangup failed” message, or worse. Here are two commands to work around 
such situations: 

SET DIAL HANGUP [ { OFF, ON } ] 

Tells Kermit whether to hang up the phone at the beginning of the dialing process. 

Use SET dial HANGUP OFF only if you get hangup-related error messages during the 
dial command or if dialing doesn’t work with dial hangup ON. 

SET DIAL MODEM-HANGUP [ { OFF, ON } ] 

Applies only when dial HANGUP is ON. When MODEM-HANGUP is OFF, C-Kermit uses 
the “hardware” method of hanging up, namely turning off the DTR signal to the 
modem for about half a second. Experience has shown that this often fails to achieve 
the desired effect, so SET MODEM-HANGUP ON tells C-Kermit to try hanging up by 
using a modem-specific command (such as Hayes ATHO), and turning off DTR only if 
a confirmation (such as OK) fails to appear from the modem, modem-hangup is ON 
by default. 

Back to our Telebit dialing example. The lines beginning with AT are commands from 
Kermit to the modem. Space does not permit describing what they do, but if you have a 
Telebit modem manual you can look them up. The OK and CONNECT lines are responses 
from the modem to Kermit. 

ATF1M1Q4X3S2=43 is the initialization string sent by Kermit to the modem; it puts the 
modem in the command and response modes that Kermit needs to control it (this com¬ 
mand contains mostly Hayes-like options that you can look up in Table II-2 on p. 366). It 
is sometimes possible to overcome dialing difficulties by changing the initialization string. 
Here’s how: 

SET DIAL INIT-STRING [ text ] 

C-Kermit’s dial command sends a preprogrammed sequence of characters to your 
modem to initialize it. Each of Kermit’s modem types has its own initialization string. 
You can use this command to substitute your own initialization string, such as atz\13 
or AT&F&D3X13 or ATS0=1\13. This command is particularly useful for forcing your 
modem to dial using certain modulation, error-correction, or compression techniques. 
See your modem manual. The text can be any reasonable length, and it can include 
imbedded carriage returns or other characters encoded in backslash notation (such as 
\ 13 for carriage return), so it can even contain more than one modem command. It 
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The Other Computer 
(REMOTE) 



should normally end with \13. If you give the SET dial initstring command with¬ 
out any text, Kermit’s default initialization string is restored. 

Use the set dial init string command with caution. Mistakes can put your modem into 
undesired and disreputable modes. If you are doing this to a modem that other people use, 
you should make sure to put it back in its normal state when you are finished using it 
(hint: read about the on_exit macro in Chapter 11). 

In the next few lines of our example, Kermit sets numerous “S-Registers” in the Telebit 
modem. These are simply set commands expressed in the modem’s own language. This 
modem has many options (maybe even more than Kermit!); see your modem manual. 
Finally, Kermit dials the number: 

ATDT741-8100 

The modem response, connect 1200, tells Kermit that the remote modem answered the 
call, but at a lower speed than the one we dialed at. Kermit noticed this and changed its 
own transmission speed to 1200 by doing a SET SPEED 1200 command internally, and in¬ 
formed you with a message, “Speed changed to 1200.” Very nice! 

Or maybe not so nice. Hayes 1200, higher-model Hayes modems, and compatibles report 
the speed of the connection (labeled B in Figure 3-6) between themselves and the other 
modem in their connect messages. But this does not necessarily mean that the interface 
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speed between the modem and C-Kermit (A in the figure) also changed. Some newer- 
model modems have a feature called speed matching, which keeps the interface speed (A) 
constant when the connection speed (B) changes. Unfortunately, speed-matching modems 
might report the connection speed (B) in the CONNECT message, rather than the interface 
speed (A). How does Kermit know how to react to the speed given in the modem’s 
CONNECT message? You must tell it: 

SET DIAL SPEED-MATCHING [ { OFF, ON ;=OFF / 

This command tells C-Kermit whether to believe the connection speed reported by 
your modem. The default setting is ON, which tells Kermit to believe it and to 
adjust its interface speed according to the modem’s CONNECT report, set dial 
SPEED-MATCHING OFF tells C-Kermit that the modem’s interface speed is locked, so 
C-Kermit should ignore the CONNECT speed reported by the modem. See your modem 
manual for further information about speed matching. As of this writing, the SET DIAL 
SPEED-MATCHING command works only for Hayes and Telebit modem types. 

More Dialing Controls 

The SET dial INIT-STRING command gives you a way to override C-Kermit’s built-in 
modem initialization and setup. However, it is sometimes necessary to change other dial¬ 
ing actions too. 

SET DIAL DIAL-COMMAND [ text ] 

Overrides C-Kermit’s built-in modem dialing command. For example, the default 
dialing command for Hayes and compatible modems is ATD followed by the phone 
number. You can use SET DIAL DIAL-COMMAND, for example, to add a T to force Tone 
dialing (or a P to force Pulse dialing), so you don’t have to put modem-specific codes 
in your dialing directory. The text must contain the characters %s, which C-Kermit’s 
dial command replaces by the telephone number. Example: 

C-Kermit >set dial dial-command ATDT%s\13 
C-Kermit >dial 7654321 

This results in ATDT7 654321 followed by carriage return (\ 13). Of course, you can 
also use this command to alter the modem-dialing command in any other way. If you 
omit the text from this command, C-Kermit’s built-in dialing method is restored. 

SET DIAL PREFIX [text] 

Tells C-Kermit to add the given text as a prefix to any telephone number before dial¬ 
ing; for example, as an area code or an access prefix to get an outside line from a 
PBX. This allows your dialing directory file to be independent of where you are dial¬ 
ing from. Here is an example that shows how to use your dial directory to dial out 
from a PBX that needs a 93 prefix for outside calls: 

C-Kermit> set dial prefix 93 
C-Kermit>dial decstore 
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Multi-Stage Dialing 

When placing long-distance modem calls, it is sometimes necessary to dial two numbers: 
one to place the desired call and the other to gain access to a long-distance carrier service 
or charge the call to another phone. 

When performing such operations with C-Kermit’s DIAL command, you must accomplish 
all phases of the call in a single DIAL command. You can’t use more than one DIAL com¬ 
mand, because the first one will fail when carrier fails to appear, and the connection will 
be dropped. Multi-stage dialing usually can be accomplished by including special codes 
in the telephone number for interpretation by your modem. For example, Hayes modems 
allow codes to pause, to wait for ringing to stop, to wait for dialtone, to perform a hook 
flash, and so on (see Table II-2 on page 366, or your modem manual). 

However, multi-stage dialing will often take longer than Kermit’s (or even the modem’s) 
time limit on waiting for carrier. So you might also have to use the SET DIAL TIMEOUT 
command to increase the limit. Here’s an example in which a long-distance call is placed 
using a calling-card number: 

C-Kermit >set modem hayes 
C-Kermit> set line /dev/cua 
C-Kermit >set speed 2400 
C-Kermit >3et dial timeout 75 

C-Kermit >dial *70-0212-555-1234,,,,,,,000 000 0000 0000 

In this example, each comma pauses two seconds, enough time for the long-distance ser¬ 
vice provider to become ready to receive the calling-card number (shown as all zeros). Do 
not put calling-card numbers in your dialing directory. If anybody else gains access to 
your dialing directory file, they can learn your calling-card number and use it to charge 
calls to your account. 

Special Modem Features 

Kermit’s SET DIAL command also lets you turn special features of your modem on and off 
without having to know the cryptic modem commands. 

SET DIAL KERMIT-SPOOF [ { OFF, ON ;=ON ] 

Certain modems made by Telebit, US Robotics, and perhaps others include a “Kermit 
spoof.” The modem itself executes the Kermit file transfer protocol. C-Kermit thinks 
it is transferring a file with the remote computer, but really it is exchanging Kermit 
packets with your local modem. The modem uses its own internal protocol to send the 
data to the remote modem, which in turn uses a Kermit spoof to transfer the data to the 
remote computer. If your modem has this feature, you can SET kermit-SPOOF on to 
enable it and SET KERMIT-SPOOF OFF to disable it. You should use the Kermit spoof if 
it results in better performance and you should turn it off if file transfer is faster with¬ 
out it. This setting is off by default. 
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SET DIAL MNP-ENABLE [ { OFF, ON j=ON ] 

Many modem modems include a feature called Microcom Networking Protocol, or 
MNP. It comes in various levels; 1 through 4 for error correction, 5 for compression, 
and others. When both modems support MNP, the highest level they share in common 
is typically used. Question: How does an MNP modem know whether to use its MNP 
features, and at what level? Answer: It “negotiates” with the other modem. 

Problem: when the calling modem supports MNP but the called modem does not, the 
MNP negotiation material sent by the called modem passes through the called modem 
to the remote computer or service. The remote computer might mistake this data for 
your user ID. In the worst case, the remote device is waiting for you to type a par¬ 
ticular character, such as carriage return, for speed recognition. When it receives the 
MNP negotiation burst instead, it picks the wrong speed and you can’t communicate at 
all even though you have a connection. 

Solution: set dial mnp-enable OFF. If C-Kermit knows how to disable your 
modem’s MNP feature, this command will do it. If not, look in your modem manual 
to find the appropriate command and use SET dial INIT-STRING to redefine your 
modem’s initialization command to include it. 


More DIAL Examples 

REMEMBER: when dialing out, you must specify a modem type, a communication 
device, and a speed in that order. Then dial the number using Kermit’s DIAL command. 
Here is an example showing how to use SET DIAL HANGUP off to get around system errors 
that occur when Kermit tries to hang up the phone in preparation for dialing: 

C-Kermit >set modem microcom (Set the modem type) 

C-Kermit >set line /dev/ttyh9 (Open the tty device) 

C-Kermit >set speed 2400 (Set desired speed) 

C-Kermit >dial 7654321 (Try to dial) 

Sorry, can't hang up communication device: device or data error 

C-Kermit >set dial hangup off (Let's try again) 

C-Kermit >set line /dev/ttyh9 (Close and reopen the device) 

C-Kermit >set speed 2400 (Set speed again) 

C-Kermit >redial (Dial again) 

Call completed. 

C-Kermit> 


Here is an example of using the unknown modem type, in which you must supply the en¬ 
tire modem dialing sequence, shown using a Hayes modem for illustrative purposes: 


C-Kermit> set modem unknown 
C-Kermit> set line /dev/ttyh9 
C-Kermit >set speed 2400 
C-Kermit> dial ATDT7654321 
Call completed. 

C-Kermit> 


(Specify generic modem dialing) 
(Open the device) 

(Set the speed) 

(Dial) 
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Note that Kermit supplies a carriage return at the end of the dial string. When the modem 
type is unknown, Kermit waits for carrier to appear from the modem if the modem, 
cable, and operating system cooperate to pass this information along to Kermit; if not, the 
DIAL command times out and you get an error message. 


Here is an example in which we place an international call that takes a long time to 
answer, using a Telebit modem that does speed matching and that has a Kermit spoof: 


C-Kermit> set modem pep-telebit 
C-Kermit> set dial speed-match off 
C-Kermit> set dial kermit-spoof on 
C-Kermit> set dial timeout 150 
C-Kermit>set line txa5: 


(Select modem type) 

(Ignore modem's speed reports) 
(Use modem's Kermit spoof) 
(Wait this long for an answer) 
(Select communication port) 
(Specify the speed) 

(Tone-dial the number) 


C-Kermit >set speed 19200 
C-Kermit >dial tO,05,11,765-4321 
Dialing tO,05,11,765-4321 
Device=_TXA5:, modem=pep-telebit, speed=19200 
The timeout for completing the call is 150 seconds. 

To cancel: type your interrupt character (normally Ctrl-C). 
Call completed. 

C-Kermit> 


In the next example we use C-Kermit to dial from the modem pool of a Rolm Com¬ 
puterized Branch Exchange (CBX) to the DEC Store, whose number is in our dialing 
directory. We enjoy watching the progress of the dialing operation so we SET DIAL DIS¬ 
PLAY ON. 


C-Kermit >set dial dir ckermit.kdd 
C-Kermit >set modem rolm 
C-Kermit >set line txa4: 
C-Kermit> set speed 1200 
C-Kermit> set dial display on 
C-Kermit >set dial prefix 93 
C-Kermit >dial decstore 
Dialing 931-800-2341998 


(Dial directory) 

(Modem type first) 

(Then communication line) 
(Then speed) 

(Watch what's happening) 
(Prefix for outside line) 
(Dial the number) 


Device=_TXA4:, modem=rolm, speed=2400 

The timeout for completing the call is 54 seconds. 

To cancel: type your interrupt character (normally Ctrl-C). 
Hangup OK 


TYPE "CALL HELP" +SEVERAL RETURNS FOR INFO (Messages from CBX...) 


CALL, DISPLAY OR MODIFY? CALL 931-800-2341998 
CALLING 931-800-2341998. MODEM 77274. 

CALL COMPLETE 

Call completed. (Kermit's message) 

C-Kermit> 

The dial display lets us see the CBX modem number, an essential item when reporting 
failures to the modem pool administrators. 
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Manual Dialing 

You can also dial a modem by hand. This might be necessary if you have a type of 
modem that C-Kermit doesn’t know about or if you want to talk to the modem directly for 
any other reason, for example to change or query its configuration. Here is an example, 
using a Hayes modem: 


C-Kermit> set carrier off (Ignore the carrier signal) 

C-Kermit> set modem none (Pretend there is no modem) 

C-Kermit> set line /dev/cua (Select communication device) 

C-Kermit >set speed 2400 (Set the communication speed) 

C-Kermit> connect (Begin terminal connection) 

Connecting to /dev/cua, speed 2400. 

The escape character is Ctrl-\ (ASCII 28, FS). 

Type the escape character followed by C to get back, 
or followed by ? to see other options. 

+++ (Get the modem's attention) 

OK (Modem responds OK) 

ATDT7654321 (Type the dialing command) 

CONNECT 2400 (Modem confirms the connection) 


(Conduct a session with the remote computer or service) 

Ctrl-\C (Escape back to the prompt) 

C-Kermit> 


Troubleshooting Dialed Connections 

For communication to work in general, and Kermit’s dial command to work at all, you 
have to ensure proper setup and configuration of Kermit, your computer, the modem, the 
modem cable, and the telephone line. And it doesn’t hurt if all the stars and planets are in 
perfect alignment too. If you can’t seem to complete a dialed call, follow these seventeen 
easy steps: 

1. Make sure your modem is turned on and connected to the phone line. 

2. Make sure your modem is connected to your computer with a straight-through modem 
cable (not with a null modem cable, see Appendix II), and that the cable has not 
wiggled loose at one or both ends. 

3. Make sure your modem cable conveys (has wires for) all the necessary signals, includ¬ 
ing SG, TD, RD, DSR, RTS, CTS, CD, and DTR (see Appendix II). 

4. Make sure the wires in the cable and the pins in the connector are not broken and that 
the pins are all sticking straight out. 

5. Make sure Kermit’s CARRIER setting agrees with your modem’s configuration. SET 
CARRIER OFF if necessary. The recommended configuration for the modem is to assert 
carrier only while it is successfully engaged with the other modem and to hang up the 
phone connection if your computer’s DTR signal goes down. Read your modem 
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manual to find out how to configure the modem this way. If it can be done with com¬ 
mands from the computer, you can use Kermit’s SET DIAL INIT-STRING command or 
you can CONNECT to the modem and do it by hand. In some cases, it might be neces¬ 
sary to change some (physical) switch settings—see your modem manual. 

6. Make sure your modem supports at least one modulation technique (Bell 103, Bell 
212, CCITT V.22, V.32, \32bis. Telebit PEP, etc.) in common with the modem you 
are calling. 

7. Make sure you have SET SPEED to a speed supported by both the local (calling) and 
remote (called) modems. 

8. Make sure your dial settings, especially speed-matching, correspond with your 
modem’s configuration. Increase the dial timeout if necessary. 

9. The hangup operation might be causing problems. Try SET dial MODEM-HANGUP off 
or SET DIAL hangup OFF before dialing. 

10. Make sure you give the appropriate SET MODEM command first, then a SET LINE com¬ 
mand for the device the modem is actually connected to, and then a SET SPEED com¬ 
mand for a speed that your modem’s dialer can handle. These commands must be 
given in the proper order. 

11. Make sure your modem’s escape sequence is not a character or sequence that you 
would need to send to the remote computer during terminal emulation or that Kermit 
would send in a file transfer packet. The default Hayes sequence, for example, is safe: 
+++ preceded and followed by at least one full second of silence. Other modems 
have been known to use unsafe sequences like a single Ctrl-A (which happens to be 
Kermit’s start-of-packet character) without any guard time; in cases like this, change 
your modem’s escape character or disable it entirely (or change Kermit’s start-of- 
packet character; see Chapter 6). 

12. If your modem has MNP or other error-correcting or compression protocols enabled, 
try turning them off. In particular, MNP modems send characters to each other after 
carrier has been established to negotiate protocol level and features. These characters 
can interfere with the remote host’s speed detection or login procedures if the answer¬ 
ing modem doesn’t support MNP. In general, take your modem down to its least 
sophisticated level and work up from there one feature at a time. 

13. Read your modem manual. Perhaps there are modem-specific characters you can 
insert in the dialing string to help the process along. For example, Hayes 2400 
Smartmodems allow W (wait for dialtone), @ (wait for silence), comma (pause), and 
so forth. Make sure your modem’s carrier wait time is not too short, that it is set for 
originate mode, and so forth. 
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14. On the other hand, maybe you inserted spacing or punctuation into your phone number 
that is not permitted by your modem. Try reissuing the DIAL command without the 
spacing and punctuation. 

15. As a semifinal resort, study your modem manual carefully to learn how to control its 
selection of modulation technique, error correction, and compression, and its fallback 
schemes for each. Experiment with different combinations of settings until you find 
one that works. 

16. If all else fails, SET CARRIER OFF, CONNECT to the modem, and try to dial manually by 
typing dialing commands in the modem’s own syntax directly at it (see your modem 
manual). If this doesn’t work, check your modem’s configuration and then repeat the 
previous steps. 

17. As a last resort, try configuring your modem to ignore DTR and always assert carrier. 
Read your modem manual to find out how to do this. 

Using Network Connections 


oooo 

If your computer is not on a TCP/IP or X.25 network, please feel free to skip 
ahead to Chapter 4 to learn how to make and use a C-Kermit terminal connec¬ 
tion to a remote computer. 

C-Kermit can be used in two ways in a computer network. You can use a network to ac¬ 
cess C-Kermit on a remote host and transfer files or you can have C-Kermit establish net¬ 
work connections itself. C-Kermit has certain advantages over other network virtual ter¬ 
minal and file transfer software: 

• The Kermit file transfer protocol can be more flexible than network file transfer. Ker- 
mit can be more adept at converting text files into useful form when transferring them 
between unlike computers. In particular, Kermit is probably unique in its ability to 
translate national and international character sets during file transfer (Chapter 9). 

• C-Kermit’s terminal connection includes features not found in most network virtual 
terminal programs, including character-set translation, key mapping, session logging, 
and support for Shift-In/Shift-Out for transmitting 8-bit characters across 7-bit connec¬ 
tions (Chapters 4 and 9). 

• Kermit’s built-in script programming language can be used to automate network file 
transfers and to set up unattended or repeated operations (Chapters 11-13). 

• Kermit’s logging facilities can be used in combination with its script programming 
language for network monitoring and reporting. 
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Remote Mode 

Using C-Kermit in remote mode over a network connection is just like using C-Kermit in 
remote mode over a direct or dialed serial connection, except that you establish the con¬ 
nection from your local Kermit program by using a networking communication method 
rather than a serial one. The following example uses MS-DOS Kermit 3.11 or later and 
assumes all the necessary SET TCP/IP information has already been supplied: 

MS-Kermit> set port tcp/ip 128.59.39.2 
MS-Kermit> connect 

In this case, the SET PORT TCP/IP command takes the place of SET PORT COM1 (or COM2, 
etc.) and DIAL. Once the connection is made, you can conduct a terminal session and 
transfer files in the normal manner. 

Local Mode 

Setting up a network connection from C-Kermit to another network host is similar to set¬ 
ting up a dialed connection, but with different commands. C-Kermit presently supports 
several network types, TCP/IP [17], X.25 [11], and DECnet. 13 The SET MODEM, SET 
carrier, SET SPEED, set dial, and dial commands have no effect on network connec¬ 
tions. The only commands needed to set up a network connection are: 

SET NETWORK { TCP/IP, X.25, DECNET } 

This command tells C-Kermit which type of network to use. This is analogous to the 
SET modem command that is used on dialed serial connections to tell Kermit which 
kind of modem to use. The available network types depend on your computer and 
operating system and, of course, whether your computer is attached to a network at all: 

C-Kermit >set network ? One of the followings 
tcp/ip x.25 

C-Kermit>set network tcp 

If you give a SET host command without a prior SET NETWORK command, a TCP/IP 
network is assumed, if it is supported. 

SHOW NETWORK 

This command shows the types of network connections and protocols available, plus 
information about the currently active network connection, if any: 

C-Kermit> sho net 
Supported networks: 

X.25 

TCP/IP, TELNET protocol 


13 As of this writing, TCP/IP support is available in the AOS/VS II version as well as in selected VMS, 
OpenVMS, and UNIX versions. X.25 support is currently available only for Sun computers equipped 
with the SunLink X.25 product. DECnet support is available only for OS/2 systems equipped with DEC 
PATHWORKS. 
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SET TELNET parameters 
echo: local 
newline-mode: on 
terminal-type: vtlOO 

Current network type: 

TCP/IP 

Active SET HOST connection: 

None 

C-Kermit> 

SET HOST [ host ] 

This command tells C-Kermit that you want to make a network connection rather than 
use a serial communication device, and it gives the name or address of the other com¬ 
puter you want to communicate with on the currently selected type of network. When 
you are making a network connection, use SET HOST instead of SET LINE and DIAL. 

The host is a network host name or number. If no host name is given, the currently 
open network connection (if any) is closed and Kermit reverts to its default communi¬ 
cation device. The set HOST command attempts to open a connection to the specified 
host immediately. If the connection cannot be established, an error message is printed. 

HANGUP 

When the current connection is via TCP/IP, X.25, or some other type of network, the 
hangup command closes the network connection. 

TCP HP Networks 

TCP/IP network hosts address each other using a protocol called IP (Internet Protocol). 
Each computer on a TCP/IP network has a 32-bit IP address, written as four decimal num¬ 
bers separated by periods, with each number between 0 and 255 (inclusive), for example: 

128.59.39.2 

The IP address is like the address on a letter; it lets an IP message travel through a compli¬ 
cated network to its destination. 

People aren’t particularly good at remembering long numbers, so IP hosts can also have 
names that stand for their numeric addresses. An IP hostname is usually a series of words 
separated by periods, for example: 
watsun.cc.Columbia.edu 

The fields in the name don’t have any particular relationship to the fields in the numeric 
address. The dotted fields represent a hierarchy from left to right, called a domain name. 
The example identifies the computer called “watsun” on the Computer Center (cc) net¬ 
work, which has many computers; at Columbia University (Columbia), which has many 
local area networks; on the educational portion of the Internet (edu), which also includes 
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many other educational institutions. The Internet has other major subdivisions besides 
“edu,” including “com” for the commercial portion, “gov” for the government portion, 
“it” for the Italian portion, and so on. 

Host names are translated to numeric IP addresses by network servers called domain name 
resolvers, or, more simply, name servers. The name server can be on your own computer, 
on some other computer on your network, or even on a distant computer outside your 
organization. 

People tend to prefer short names to long ones. Therefore IP hosts can have nicknames, 
like “watsun” or “w” for watsun.cc.columbia.edu. Nicknames are generally 
valid only within an organization’s local network and are translated to IP numbers by a lo¬ 
cal name server. 

C-Kermit’s SET HOST command accepts any of these forms. If you give a name, C-Kermit 
attempts to find a name server that will supply the corresponding address. If you give a 
numeric address, C-Kermit uses it directly, without attempting to contact a name server. 
Thus if you have trouble making a TCP/IP connection to a host by name, try its IP address 
instead if you know it. Here are some examples showing how to establish connections 
with the SET HOST command: 

C-Kermit> set net tcp (Choose network type) 

C-Kermit> set host ? IP host name or number, 
or carriage return to close an open connection 
C-Kermit>set host watsun (Unknown nickname) 

Can't get address for watsun 

C-Kermit >set host watsun.cc.columbia.edu (Full domain name) 

C-Kermit> set host 128.59.39.2 (IP address) 

C-Kermit> set host (Close the connection) 

Closing Connection 
C-Kermit> 

You should use names rather than numbers when possible, because numbers can change 
without your knowledge. The name server, however, is supposed to have a current num¬ 
ber for each name. 

C-Kermit connects to the telnet server (TCP port 23) on the remote host by default, but 
you can specify any desired TCP port or service after the IP host name or address: 

SET HOST host service 

or you can append it to the host field with a colon (no spaces): 

SET HOST host'.service 

As with addresses, Kermit calls upon the operating system to translate a service name 
(like telnet) into a TCP port number. If you give a port number, it is used as is. Here are 
some examples: 
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C-Kermit> set host watsun (Default is port 23) 

C-Kermit> set host watsun 23 (Port 23 specified) 

C-Kermit> set host 128.59.39.2 telnet (TELNET is port 23) 

C-Kermit> set host martini.eecs.umich.edu:3000 (Port 3000) 
C-Kermit> set host 141.212.196.79 3000 (Port 3000) 

C-Kermit> set host marvin.cs.buffalo.edu:2000 (Port 2000) 

The SET HOST command displays the translation from IP host name to numeric IP address: 

C-Kermit> set host marvin.cs.buffalo.edu:2000 
Trying 128.205.32.4... 

and then tries to establish the connection. If the connection cannot be made, you will get 
an informative error message. Examples: 

C-Kermit> set host 123.123.123.123 
Trying 123.123.123.123... 

Sorry, can't open connection: Network is unreachable 
C-Kermit >set host watsun foo 
Trying 128.59.39.2... 

Sorry, can't open connection: Cannot find port for service foo 
C-Kermit >set host watsun 2345 
Trying 128.59.39.2... 

Sorry, can't open connection: Connection refused 

The first message means either that there is no such IP address, or that the network im¬ 
plied by the IP address cannot be located or reached. The second message means that the 
TCP service-name database did not contain an entry for a service called foo. The last 
message indicates that there is no server on TCP port 2345 at host watsun. 

Use the SHOW NETWORK command to display the name, address, service, network, and 
protocol of an active connection: 

C-Kermit> sho net 
Supported networks: 

X. 25 

TCP/IP, TELNET protocol 

SET TELNET parameters: 
echo: local 
newline-mode: on 
terminal-type: vt300 

Current network type: 

TCP/IP 

Active SET HOST connection: 
marvin.cs.buffalo.edu:3000 [128.205.32.4] 

Via: TCP/IP (sockets) 

TELNET protocol 

C-Kermit> 
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The TELNET command combines the functions of SET NETWORK TCP/IP, SET HOST, and 
CONNECT (explained in Chapter 4) into one convenient command: 

TELNET [ host [ service ] ] 

Opens a connection to the specified IP host on the designated TCP port (23 = telnet 
by default). If successful, C-Kermit enters CONNECT mode automatically, otherwise it 
issues an appropriate error message and remains at the prompt. If a host is not 
specified, the currently active TCP/IP connection, if any, is resumed. Examples: 

C-Kermit> telnet ? IP host name or number, 
or carriage return to resume an open connection 
C-Kermit>telnet watsun ? TCP service name or number, 
or carriage return for telnet (23) 

C-Kermit> telnet watsun 2000 

C-Kermit> telnet (Resume an open connection) 


C-Kermit performs TELNET option negotiation protocol [51] automatically. These negoti¬ 
ations are used to inform the remote host of your terminal type and to determine which 
side does the echoing. If the TCP service port is TELNET (23), Kermit sends the initial 
negotiations. Otherwise, Kermit sends no TELNET negotiations, but is prepared to handle 
them if they should arrive from the remote host. Negotiations can take place at any time 
during the connection: in connect mode (for example, to turn echoing off and on around 
password entry), during script program execution, and so on. 

The SET TELNET command can be used to alter C-Kermit’s initial telnet configuration: 

SET TELNET ECHO { REMOTE, LOCAL } 

In accordance with the TELNET Network Virtual Terminal specification [51], C-Kermit 
begins a TELNET connection in local-echo mode, meaning C-Kermit itself echoes the 
characters that you type on the keyboard. In the rare cases where this causes problems 
(for example with a remote server that does not properly follow the TELNET protocol), 
you can use this command to change C-Kermit’s initial echoing state. 

SET TELNET NEWLINE-MODE { ON, OFF } 

The telnet specification also states that when you press the Return or Enter key, this 
should be transmitted to the telnet server as a carriage-return and linefeed pair 
(CRLF). This is what C-Kermit does unless you give the command SET TELNET 
newline-mode off, in which case C-Kermit sends the Return or Enter key as a car¬ 
riage return followed by the null character. Use this command only if your telnet 
session doesn’t behave normally without it. 

SET TELNET TERMINAL-TYPE text 

The remote telnet server might request C-Kermit to send your local terminal type. 
Unless you say otherwise, C-Kermit sends what it believes your terminal type to be. 

In UNIX, VMS, and Open VMS, for example, this is based on the value of the TERM 
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environment variable. But if the remote system does not support your terminal type or 
recognize its name, it won’t be able to set your terminal type automatically. Use this 
command to tell C-Kermit the terminal name to use in TELNET negotiations. Example: 
C-Kermit> set telnet term vtlOO 
This command does not affect your local terminal type. 

Here is an example showing how to use C-Kermit to connect from a TCP/IP host to the 
Internet Network Information Center (NIC), a source of information about the Internet. 

$ kermit (Start Kermit) 

C-Kermit 5A(188) 23 Nov 92, SunOS 4.1 
Type ? or HELP for help 

C-Kermit >telnet nic.ddn.mil (Connect to host) 

Trying 192.112.36.5... 

Connecting to host nic.ddn.mil:23 

The escape character is Ctrl-\ (ASCII 28, FS). 

Type the escape character followed by C to get back, 
or followed by ? to see other options. 

SunOS UNIX (nic.ddn.mil) (ttypO) 

* 

* For TAC news, type: TACNEWS <return> 

* For user and host information, type: WHOIS <return> 

* For NIC information, type: NIC <return> 

* 

* Please report system problems to ACTI0N@NIC.DDN.MIL 

NIC, SunOS Release 4.1.1 (NIC) #1: 

Cmdinter Ver 1.2 Sun Jun 7 18:55:09 1992 EST 

(Have a session) 

8 logout 

Communication disconnect (Back at Local System) 

C-Kermit >exit (Leave Kermit) 

$ (Back where we started) 

Several special features are available for testing and managing your TCP/IP connection. 
At the C-Kermit prompt, you can use the ping command: 

PING [ host ] 

to send an IP message to see if the host is reachable and responsive. If a host is not 
specified, the message is sent to the current SET host or TELNET host. This command 
simply runs your system’s PING command, so the response depends on your system: 

C-Kermit> set host spacelink.msfc.nasa.gov 
C-Kermit> ping 

spacelink.msfc.nasa.gov is alive 
C-Kermit> 
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The other special features are available as CONNECT-mode escape commands and are 
described in Chapter 4, but they are also listed here for completeness: 

A Send a telnet “Are You There?” command. 

B Send a telnet Break command. 

I Send a telnet Interrupt Process command. 

How to Dial Using a TCP/IP Modem Server 

If your site maintains a pool of dialout modems on a “reverse terminal server” that is on 
your TCP/IP network, you can use C-Kermit to dial out by following these steps in the or¬ 
der given: 

1. Give a SET HOST (not TELNET) command, specifying the IP host name or numeric ad¬ 
dress of the terminal server. 

2. Give a SET MODEM command to specify the type of modem. 

3. Issue any necessary set dial commands. 

4. Give a DIAL command for the desired phone number. 

If the connection succeeds but echoing is incorrect, you can try giving a SET TELNET ECHO 
REMOTE (or LOCAL) command as a first step, or else give a set terminal ECHO REMOTE 
(or LOCAL) command after the connection is made. 

X.25 Networks 

As of this writing, X.25 connections are supported only for Sun computers that have the 
SunLink X.25 package and a connection to an X.25 network, such as the public data net¬ 
works found in many countries (SprintNet or Tymnet in the US, Datapac in Canada, for 
example). Use the show network command to find out if X.25 support is available in 
your version of C-Kermit. 

For X.25 connections, an X.121 [14] address is used in the set host command; this is a 
many-digit number usually consisting of a 1-digit prefix, a 4-digit DNIC (Data Network 
Identification Code) followed by an NTN (Network Terminal Number) up to 10 digits in 
length, or a 3-digit DCC (Data Country Code) followed by a country-dependent NN (Na¬ 
tional Number) up to 11 digits in length. For example, the following sequence might set 
up a connection to a hypothetical host in Brazil (Country Code 724): 

C-Kermit> set parity mark 
C-Kermit >set net x.25 
C-Kermit >set host 07240987654321 

In most cases, you should SET parity to mark (or some other value besides NONE) before 
attempting to transfer files over an X.25 connection. 
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Before giving a SET HOST command for an X.25 connection, you can issue the following 
commands to specify how the connection is to be made: 

SET X.25 CALL-USER-DATA { OFF, ON text} 

Lets you specify up to 12 characters of “call user data,” usually an identifier or 
password required by the host you are calling. Consult the instructions from your ser¬ 
vice provider to see if you need to send call user data and what it should be. 

SET X.25 CLOSED-USER-GROUP { OFF, ON n } 

Membership in a closed user group gives you access to addresses that might otherwise 
be off limits. C-Kermit assumes no user group. If you need to access a service that is 
in a closed user group, use SET x.25 CLOSED-USER-GROUP ON n to specify a closed user 
group number, 0 to 99. 

SET X.25 REVERSE-CHARGE { OFF, ON } 

Normally, the caller pays for an X.25 call. If the remote host or service is willing to 
pay for your call, use set x.25 reverse-charge ON. The default is off. 

An X.25 terminal connection goes through a PAD (Packet Assembler Disassembler), 
which is something like an autodial modem or a terminal server. You can converse with it 
directly (in command mode) or have it pass your data through to the selected host (data 
mode). When your local host is connected directly to the X.25 network (as opposed to 
dialing up a PAD), it takes the place of the PAD, and you have to use C-Kermit com¬ 
mands to control the simulated PAD: 

PAD CLEAR 

Clears the X.25 virtual circuit. Discards any information that might be in transit. 

PAD INTERRUPT 

Sends an X.25 interrupt packet. 

PAD RESET 

Resets the X.25 virtual circuit. 

PAD STATUS 

Requests a status report from the PAD. 

C-Kermit also sets the PAD parameters itself. Each of these commands controls a dif¬ 
ferent PAD parameter. The numbers correspond to CCITT X.3 parameters [10]. X.3 
parameter numbers higher than 12 are not necessarily available on all X.25 networks. 

SET PAD BREAK-ACTION n 

X.3 Parameter 7, or what the PAD should do if it receives a BREAK signal 
(escape-character followed by B) from C-Kermit. n is the sum of the following digits: 
0 means nothing, 1 means send an X.25 Interrupt packet, 2 means reset the connec- 


Using Network Connections 75 



tion, 4 means send an Indication of Break message, 8 means escape back to the PAD, 
16 means discard pending output. The default is 21 (= 16 + 4 + 1). 

SET PAD CHARACTER-DELETE n 

X.3 Parameter 16. n = 0-127, the ASCII value of the character to be used for erasing 
a character during terminal emulation. The default is 8 (Ctrl-H, Backspace). 

SET PAD CR-PADDING n 

X.3 Parameter 9, Padding After Carriage Return (CR). n = 0-255, the number of pad¬ 
ding characters the PAD should send to C-Kermit after sending a CR, default 0. 

SET PAD DISCARD-OUTPUT { 0,1 } 

X.3 Parameter 8. 0 means normal data delivery, 1 means discard output, default 0. 

SET PAD ECHO { 0,1 } 

X.3 Parameter 2. 0 means the PAD will not echo, 1 means the PAD will echo. The 
default is 1 (Kermit assumes the PAD will echo). This command also changes 
Kermit’s duplex setting. 

SET PAD EDITING {0,1} 

X.3 Parameter 15. 0 means you can’t edit the lines you type at the PAD before it 
sends them to the host, 1 means editing is allowed. The default is 1. 

SET PAD ESCAPE f0,lj 

X.3 Parameter 1. 0 means escaping back to the PAD is not possible, 1 means you can 
use Ctrl-P to escape to the PAD. The default is 1. 

SET PAD FORWARD n 

X.3 Parameter 3, Data Forwarding Characters. The PAD forwards the characters it 
has received to the remote host as soon as it sees the packet forwarding character, n = 
0 means none, 2 means carriage return. The default is 2, to make X.25 packets cor¬ 
respond as much as possible with Kermit packets. 

SET PAD LF-PADDING n 

X.3 Parameter 14. n = 0-255, the number of padding characters to be sent by the PAD 
after it sends a linefeed. The default is 0. 

SET PAD LF-INSERT n 

X.3 Parameter 13, Linefeed (LF) Insertion after Carriage Return (CR). n = 0 means 
no LF insertion, 1 means the PAD inserts a LF after each CR sent to C-Kermit, 2 
means the PAD inserts a LF after each CR received from C-Kermit, 4 means the PAD 
echoes LF as CRLF. The default is 0. 

SET PAD LINE-DELETE n 

X.3 Parameter 17. n = 0-127, the ASCII value of the character to be used for erasing 
a line. The default is 21 (Ctrl-U). 
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SET PAD LINE-DISPLAY n 

X.3 Parameter 18. n = 0-127, the ASCII value of the character you can type to 
redisplay an edited line. The default is 18 (Ctrl-R). 

SET PAD LINE-FOLD n 

X.3 Parameter 10, Line Folding, or what to do when a line is too long to fit on your 
screen, n = 0 means no line folding, 1-255 specifies the number of graphic characters 
per line after which the PAD should insert folding characters. The default is 0, and 
should be kept at 0 during file transfer to prevent damage to Kermit’s file transfer 
packets. 

SET PAD PAD-FLOW-CONTROL { 0 , 1 } 

X.3 Parameter 5. 0 means no flow control by the PAD, 1 means the PAD may send 
Xon/Xoff flow control to C-Kermit. The default is 0, which allows Xon/Xoff flow 
control to work end-to-end. 

SET PAD SERVICE-SIGNALS { 0,1 } 

X.3 Parameter 6, PAD Service and Command Signals. 0 means PAD service signals 
are not sent to C-Kermit, 1 means PAD service signals sent. The default is 1. 

SET PAD TIMEOUT n 

X.3 Parameter 4, Data Forwarding Timeout, n = 0-255 (twentieths of a second), how 
long the PAD should wait for its packet buffer to fill up or for a forwarding character 
to appear before it times out and transmits what it has so far. The default is 0, no data 
forwarding on timeout. 

SET PAD USER-FLOW-CONTROL { 0,1 } 

X.3 Parameter 12. 0 means the PAD should ignore any flow control characters sent by 
C-Kermit, 1 means the PAD should pay attention to them. The default is 0. 

During connect mode, the following X.25-specific keyboard escape options are avail¬ 
able. Type these letters in after typing the CONNECT-mode escape character (normally 
Control-Backslash): 

I Send an X.25 Interrupt packet. Equivalent to PAD INTERRUPT. 

R (X.25 only) Reset the X.25 connection. Equivalent to PAD RESET. 

It is beyond the scope of this book to go into any more detail about X.25 networks. See 
the manual from your X.25 service provider, the relevant CCITT Recommendations 
[10, 11, 12, 13, 14], or Kermit, A File Transfer Protocol [18, pp. 98-102], 
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Chapter 4 


Terminal Connection 


oooo 

If you will not be using C-Kermit in local mode to establish connections to other 
computers, skip this chapter and proceed to Chapter 5 on page 95 to learn how 
to transfer files. 

C-Kermit’s CONNECT command lets you carry on an interactive dialog with a remote com¬ 
puter or service. It works in both the 7-bit and 8-bit communication environments, on 
both full and half duplex connections. It includes a mechanism for shifting back and forth 
between the remote and local computer, a way to record the remote session, character-set 
conversion, and a key mapping feature. 

When you use C-Kermit in local mode, no matter what your connection method—dialup, 
direct, or network—the method of shifting back and forth between the two computers is 
the same: use the connect command at the C-Kermit prompt to go to the remote com¬ 
puter, and type a special character sequence to get back to C-Kermit. 

The CONNECT Command 


The connect command makes C-Kermit act like a terminal connected to the remote com¬ 
puter. The characters you type on your keyboard are sent to the remote computer, and all 
the characters that arrive from the remote computer are sent to your screen, as shown in 
Figure 4-1 on the next page. HINT: The CONNECT command can be abbreviated by a 
single letter, c, even though several other Kermit commands also begin with C. 
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Figure 4-1 Terminal Connection 
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The Escape Character 

Typing the escape character regains the attention of the local C-Kermit program during a 
CONNECT session. When you give the CONNECT command, C-Kermit tells you what the 
escape character is: 

C-Kermit> connect (Begin terminal connection) 

Connecting to ttxaOs, speed 19200. (Messages from C-Kermit...) 

The escape character is Ctrl-\ (ASCII 28, FS). 

Type the escape character followed by C to get back, 
or followed by ? to see other options. 

Ctrl-\ (Control-Backslash) is C-Kermit’s normal escape character. It is produced by hold¬ 
ing down the Ctrl (or Control) key and pressing the backslash (\) key. 14 This gets 
C-Kermit’s attention. Now follow the escape character by a second character that tells 
C-Kermit what to do, such as the letter C to return to the C-Kermit prompt without break¬ 
ing the connection. 

SET ESCAPE number 

Changes the escape character to the control character of your choice; number is the 
numeric value of an ASCII control character, as listed in Table VIII-2. Example: 

C-Kermit >set esc 2 
C-Kermit> show escape 

CONNECT-mode escape character: Ctrl-B (ASCII 2, STX) 

C-Kermit> 


14 The keyboards on most NeXT workstations do not generate the Control-Backslash character. The 
NeXT version of C-Kermit uses Control-Rightbracket as its escape character. OS/2 C-Kermit also uses 
Ctrl-Rightbracket. Be sure to pay attention to the connect message. 
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This changes your CONNECT-mode escape characer to Control-B (ASCII character 
number 2, called STX). Only 7-bit control characters (codes 0 through 31 and 127) 
may be used for this purpose. You should select a character that you are unlikely to 
use at the remote host and that you are able to generate on your local keyboard. You 
can use show escape or show terminal to fmd out the current escape character. 


The mechanics of terminal connection are easy after a few minutes of practice. Use 
CONNECT to go to the remote host and use Ctrl-Backslash C (hold down the Ctrl key, press 
the backslash (\) key, then let go of both these keys, then press the C key) to escape back 
to C-Kermit. If your escape character isn’t Ctrl-Backslash, make the appropriate substitu¬ 
tion. Now practice going back and forth a few times. In this example, we have a direct 
connection from a VAX workstation to a central computer: 

C-Kermit> set line ttxaO; (Direct connection) 

C-Kermit >set speed 19200 (Set the speed) 

C-Kermit >connect (Begin terminal connection) 

Connecting to ttxaO:, speed 19200. 

The escape character is Ctrl-\ (ASCII 28, FS). 

Type the escape character followed by C to get back, 
or followed by ? to see other options. 


WELCOME TO RALPH'S ACADEMY OF BRAIN SURGERY 
EARN WHILE YOU LEARN 1 


Username: olaf 

Passwords _ 

$ Ctrl-\c 
C-Kermit> pwd 
$DUA0:[OLAF] 


(Log in) 

(Supply your password) 
(Escape back) 

(Give a C-Kermit command) 


C-Kermit >set esc 22 (Change the escape character) 

C-Kermit>c (Connect again) 

Connecting to ttxaO:, speed 19200. 

The escape character is Ctrl-V (ASCII 22, SYN). 

Type the escape character followed by C to get back, 
or followed by ? to see other options. 

$ (Back at Ralph's) 

5 show time (Give a command) 


ll-JUN-92 19:44:00 

$ Ctrl-Vc (Escape back again) 

C-Kermit> run fortune (Give a C-Kermit command) 

The brain is a wonderful organ; it starts working the moment you 
get up in the morning and does not stop until you get to school. 
C-Kermit>c (Connect again) 


You can connect and escape back as often as you like. Escaping back does not break the 
connection. If characters arrive from the remote computer or service while you are not 
CONNECTed, they are buffered to the capacity of the underlying operating system. If the 
operating system’s buffer becomes too full, flow control, if in effect, should prevent any 
loss of characters. 
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Closing the Connection 

When you’re finished using the remote computer, you should close the connection. There 
are several ways to do this. You should try them in this order: 

1. If you were logged in to the remote computer or service, log out from it. This should 
pop you back to the C-Kermit prompt automatically. Example: 

$ logout 

Communications disconnect (Back at local system) 

C-Kermit> 

2. If you’re not back at the C-Kermit prompt yet, type Ctrl-\H (your CONNECT-mode 
escape character followed by the letter H) to hang up the connection: 

Ctrl-\h 

Communications disconnect (Back at local system) 

C-Kermit> 

3. If you’re still not back at the C-Kermit prompt yet, type Ctrl-\C to return to the 
C-Kermit prompt and give the SET LINE command to close the communication device: 

Ctrl-\c 

(Back at local system) 

C-Kermit >set line 
C-Kermit> 

CONNECT-Mode Keyboard Escape Commands 

C-Kermit’s escape-character functions are listed in Table 4-1. Let’s look at them in detail. 
When the connect command is active, C-Kermit monitors the keyboard for its CONNECT- 
mode escape character, which (in most versions) is Ctrl-Backslash unless you have used 
the SET ESCAPE command to change it (OS/2 C-Kermit also accepts certain Alt-key equiv¬ 
alents; see Appendix V). When Kermit sees its escape character, it interprets the next 
character from the keyboard as a special CONNECT-mode command. If you press a key 
that is not a valid CONNECT-mode command, Kermit beeps, ignores the key, and remains 
in CONNECT mode. 

If you type the escape character and then decide you didn’t mean to do it, just press the 
space bar. C-Kermit ignores the escape character and the space bar, and does not beep at 
you. No characters are transmitted to the remote computer, and Kermit remains in 
CONNECT mode. 

Kermit’s CONNECT-mode escape commands are described in the following sections. Let¬ 
ters are shown in uppercase, but they may be entered in either upper- or lowercase. Each 
command must be preceded by Kermit’s CONNECT-mode escape character. 
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Table 4-1 C-Kermit CONNECT-Mode Escapes 


Character Description 

? Help— prints the available CONNECT-mode escape options. 

1 (also §) Enters the local system command processor. EXIT or LOGOUT to return to 
C-Kermit CONNECT mode. 

0 (the digit zero) Transmits a NUL (ASCII 0). 

A Sends “Are You There?” (telnet only). 

B Transmits a BREAK signal. 

c Returns to the C-Kermit prompt without breaking the connection. 

H Hangs up the phone or network connection. 

I Sends a network Interrupt request. 

L Transmits a Long BREAK signal. 

Q Hangs up, closes the connection, and quits from C-Kermit. 
r (X.25 only) Resets an X.25 connection. 

s Shows the status of the connection: device name, speed, parity, etc. 

z (UNIX only) Suspends Kermit. Use the UNIX f g command to continue Kermit’s 

CONNECT session. 

sp (Space) Sends nothing, stays in connect mode. 

\ (Backslash) Introduces a backslash code that translates into a single character, for 
example \ 127 or \xff. 

Ctrl-\ (or whatever your escape character is) Type the escape character twice to send one 
copy of it to the remote computer. 


Getting Help: ? 

Typing the escape character followed by question mark lists the available CONNECT-mode 
escape options. These can vary depending on the C-Kermit version and the features it was 
built with. This message tells you which ones are available in your version. Example: 
Ctrl-\? 

Press C to return to the C-Kermit prompt, or: 

? for this message 
0 (zero) to send a null 
B to send a BREAK 
L to send a Long BREAK 
H to hangup and close the connection 
Q to hangup and quit Kermit 
S for status 

1 to push to local shell 
Z to suspend 
\ backslash code: 


CONNECT-Mode Keyboard Escape Commands 
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\nnn decimal character code 
\Onnn octal character code 
\Xhh hexadecimal character code 
terminate with carriage return. 

Type the escape character again to send the escape character, or 
press the space-bar to resume the CONNECT command. 

Command> 

After printing the help text, C-Kermit prints a prompt, Command>, and waits for you to 
enter one of the options just listed. 

Returning to the C-Kermit Prompt: C 

Typing the escape character followed by the letter C returns you to the C-Kermit prompt 
without breaking the connection to the remote computer. This is called escaping back. 
After escaping back, you can give commands to C-Kermit to change its settings, transfer 
files, and so forth. Give another CONNECT command to get back to the remote computer. 
Example: 

C-Kermit>connect 
$ 

$ l\c 
C-Kermit> 

C-Kermit>connect 
$ 

Status Inquiry: S 

Typing the escape character followed by the letter S tells Kermit to print a brief message 
showing the status of the connection and then resume the connect session. Example: 

c-Kermit>connect 

$ 

$ ~\a 

Connected through /dev/ttyh8, speed 9600 
Terminal bytesize: 7, Command bytesize: 7, Parity; none 
Terminal echo; remote 
Carrier Detect (CD): On 

Dataset Ready (DSR): Off 

Clear To Send (CTS): Off 

Ring Indicator (RI): Off 

Data Terminal Ready (DTR): On 

Request to Send (RTS): On 

$ 

The report includes the communication device name and relevant parameters, plus (for 
serial devices only, and only if your system supports it) a report of the RS-232 modem 
signals (listed and explained briefly in Table II-1 on page 364). The status report is useful 
if you have trouble communicating during CONNECT mode. The information shown here 
might indicate the cause: wrong device, wrong speed, a missing modem signal, and so on. 


(Connect to remote computer) 
(Remote computer's prompt) 
(Escape back to C-Kermit) 
(C-Kermit’s prompt) 

(Return to remote computer) 
(Remote computer's prompt) 
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Escape to Local System:!, @ 

Typing the escape character followed by an exclamation mark (l) or at-sign (§) tells 
C-Kermit to start an “inferior” copy of your system’s command processor, such as the 
UNIX shell or VMS or AOS/VS command line inteipreter, leaving your Kermit connec¬ 
tion open. 15 This is similar to putting a telephone call on hold. You can have an inter¬ 
active dialog with your system for as long as you like without disturbing your Kermit con¬ 
nection. To return to your Kermit CONNECT session, use the appropriate command to exit 
from the system command processor (EXIT in UNIX or OS/2, LOGOUT in VMS, POP in 
AOS/VS, and so on). Example: 


$ kermit 

C-Kermit> set line /dev/ttyl 
C-Kermit >set speed 19200 
C-Kermit>connect 
Connecting to /dev/ttyls, speed 


(Start Kermit) 

(Select communication device) 
(and speed) 

(Start CONNECT session) 

19200, etc... 


logins ivan (Log in) 

Passwords _ (Enter password) 

% 


% send olga Hi, are you ordering pizza for lunch? 

% message from olgas OK, but I need the phone number. 

% send olga OK, wait a second... 

% 

% A M (Escape to local shell) 

$ 


$ grep "Yummy Pizza" phones.txt 
Yummy Pizzas 765-4321 
$ exit 
% 

% send olga It's 765-4321. 

% 


(Look up phone number) 

(Exit local shell) 
(Resume CONNECT session) 


In UNIX only, you can also follow the escape character by the letter Z to suspend Kermit, 
if suspend is SET to ON. See Appendix III for details. 

Sending BREAK Signals: B and L 

Typing the escape character followed by the letter B tells C-Kermit to transmit a BREAK 
signal. On serial (terminal device or modem) connections, BREAK is a spacing (0) con¬ 
dition lasting about 275 milliseconds (slightly more than a quarter of a second), required 
by some hosts, services, and communication processors for transmission speed recog¬ 
nition, to get their attention, or to interrupt a runaway or stuck process. Here’s an example 
showing how to log in to an IBM VM/CMS mainframe over a linemode connection, in 
which you are instructed to “press BREAK key.” The setup and connection details are 
omitted. 


15 If this feature is missing from your version of C-Kermit, then it has been built with the nopush option 
to prevent users from directly accessing the system from within Kermit. 
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C-Kermit> connect 

Connecting to /dev/cua, speed 9600... 

VIRTUAL MACHINE/SYSTEM PRODUCT—CUVMB —PRESS BREAK KEY 

A \b 
1 

Enter one of the following commands: 

LOGON userid (Example: LOGON VMUSER1) 

LOGOFF 
■ logon olga 

Enter password: _ 


Typing the letter L instead of B after the escape character tells C-Kermit to transmit a 
Long BREAK signal. On serial connections, this is a spacing condition lasting about 1.5 
seconds that is used to get the attention of certain communication devices. 

Network Functions 

On network connections, some of the CONNECT-mode escapes behave differently and 
some additional ones are available. Type the escape character followed by: 

A (telnet only) Send a TELNET “Are You There” message. If the remote telnet serv¬ 
er is active, it will send back a message like “[Yes].” This usually works only on true 
port-23 TELNET connections, not when you TELNET to non-TELNET ports. 

I Send an Interrupt message (X.25 Interrupt or TELNET Interrupt Process). The action 
taken depends on the network and the remote host. Sending a telnet interrupt is 
usually equivalent to typing the remote host’s interrupt character. 

B Send a network BREAK. Again, the interpretation depends on the network and the 
remote host. On telnet connections, a telnet protocol Break message is sent, 
which might be interpreted by the remote TELNET server as a stand-in for the BREAK 
signal as it is used on serial connections, or as an interruption command. 

L On network connections, L is treated exactly like B. 

Sending Special Characters 

Several methods are provided for sending special characters to the remote host during a 
connect session. Type the CONNECT-mode escape character followed by: 

0 (the digit zero) Transmit a NUL (ASCII 0). This is useful if your remote computer or 
application wants you to send a NUL character, but your keyboard doesn’t give you a 
way to type it. 

A \ (Ctrl-Backslash, or whatever you have set the escape character to be) Type the escape 
character twice in a row to send one copy of it to the remote computer. 
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A more general technique lets you transmit any character at all. If you follow the 
CONNECT-mode escape character with a Backslash (\) (not Control-Backslash) character, 
then you can enter a number representing any 7- or 8-bit code for Kermit to send. 

The backslash is followed by an optional base indicator: d for decimal, o for octal, or * for 
hexadecimal, and then a 1-, 2-, or 3-digit number in the indicated base (hexadecimal num¬ 
bers must be exactly two characters long), which Kermit interprets as a character code be¬ 
tween 0 and 255 inclusive. If there is no base indicator, base 10 is assumed. 

Terminate the code by pressing the Return or Enter key, and Kermit sends the character 
represented by the code. The carriage return itself is not sent. If you type an ungrammati¬ 
cal backslash code, Kermit beeps and sends nothing. In all cases, Kermit leaves you in 
CONNECT mode after processing the backslash code. 

Suppose your keyboard has a broken A key. The ASCII code for uppercase A is 65 
decimal, 101 octal, or 41 hexadecimal (see Table VIII-1). During a CONNECT session, you 
can transmit it in any of these ways: 

"W65 

A \\d65 

"WolOl 

A \\x41 

For example: 

I wish my *\\65 
key worked. 

The host will receive: 

I wish my A key worked. 

Hanging Up and Quitting: H and Q 

Typing the escape character followed by the letter H tells C-Kermit to hang up. On dialed 
serial connections when DIAL MODEM-HANGUP is ON, Kermit attempts to put the modem 
in command mode and then gives it the command to hang up the phone. If modem- 
hangup is off, or if it doesn’t work, or if the modem type is direct, Kermit turns off the 
Data Terminal Ready (DTR) signal for about half a second. If your serial communication 
device is connected to a modem, this is supposed to signal the modem to hang up the 
phone connection. Network connections are simply closed. If you are running C-Kermit 
in interactive mode, a successful hangup should return you automatically to the C-Kermit 
prompt. If you started C-Kermit with the -c or -n command-line option, hanging up 
should return you to the system prompt (see Chapter 14). 

Typing Q instead of H after the escape character tells C-Kermit to hang up and then quit 
(exit), returning you to the system prompt no matter how you started C-Kermit. 
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Terminal Emulation 


The OS/2 version of C-Kermit has its own built-in emulator for DEC VT102, VT100, and 
VT52 terminals and includes several capabilities not described in this chapter. See Ap¬ 
pendix V for OS/2-specific information. In other C-Kermit versions, most screen format¬ 
ting and other terminal-specific operations during CONNECT sessions are handled exter¬ 
nally to C-Kermit. 

If you have a UNIX, VMS, Open VMS, OS-9, Atari, or Amiga workstation on your desk, 
the specific terminal emulation is provided by workstation services. For example, on a 
DEC VAXstation running VMS, Open VMS, or ULTRIX with DECwindows, your access 
to the system command parser (VMS DCL or UNIX shell) is through a character-mode 
terminal emulation window that emulates a DEC VT terminal. When you run C-Kermit in 
this window the VT terminal emulation remains in effect, so escape sequences sent by the 
remote host are processed correctly in CONNECT mode. Workstation terminal windows 
can also provide services like scroll bars to view material that has scrolled off the screen, 
printing, resizing, cut and paste, font selection, and so on. 

Similar comments apply to Sun Workstations (using the standard console driver or the 
VTTOOL or CRTTOOL programs under SunView), NeXT workstations using the TERMINAL 
or STUART window), X Window System stations (using xterm) [49], SCO Xenix or UNIX 
workstations (using the ANSI terminal driver), the IBM RS/6000 with AIX Windows, and 
so forth. System V consoles on PC-based or other workstations generally follow VT100 
(ANSI) conventions via a terminfo entry (such as AT386). On the Commodore Amiga, 
the console device automatically provides ANSI terminal emulation, similar to VT100. 
On the Atari ST, the console driver provides a superset of VT52 emulation. 

Setting Terminal Parameters 

The following commands control the number of data and parity bits used during 
C-Kermit’s connect command and other terminal-oriented operations. 

SET COMMAND BYTESIZE {7,$} 

Tells whether to use 7 or 8 data bits per character on the connection between C-Kermit 
and your keyboard and screen, shown in Figure 4-2 as (A). The default is to use 7 
data bits and ignore the 8th bit. This setting applies to both command mode (when 
you see the C-Kermit prompt) and CONNECT mode. 

SET TERMINAL BYTESIZE {7,S} 

Tells whether the CONNECT command should use 7 or 8 data bits per character on the 
connection between C-Kermit and the other computer, shown in Figure 4-2 as (B). 

The default is to use 7 data bits. If you give a value of 8, then 8-bit characters are used 
if parity is set to none, otherwise 7-bit characters are used. 


88 Terminal Connection / Chapter 4 




Terminal 
or Emulator 
or Console 


—®— 

SET COMMAND 
BYTESIZE 



SET TERMINAL 1 



BYTESIZE ! 


C-Kermit 

-(D-j 

Remote Host 


SET PARITY ! 



Figure 4-2 Command and Terminal Bytesize 


SET PARITY [ { EVEN, ODD, MARK, SPACE, NONE } ] 

Tells which kind of parity to use on the connection between C-Kermit and the remote 
computer, (B). The default parity is none. A parity setting of EVEN, ODD, mark, or 
space causes C-Kermit to use 7 data bits per character, regardless of the terminal 
bytesize setting. A parity setting of none allows the terminal bytesize setting to 
determine the number of data bits per character. 

Remember, the default setting for parity is NONE, and the default setting for both 
COMMAND and terminal bytesize is 7. This is because it is common for remote hosts or 
services, or the devices that connect you to them, to use (add or strip) parity. And it is just 
as common for users to be unaware of it. 

If the bytesizes were set to 8 rather than 7 by default, parity bits on characters arriving 
from the remote host or service would change them into other characters and you would 
see gibberish on your screen. If C-Kermit’s default parity was not NONE, this could 
prevent non-parity connections from working. 

The default settings allow the initial connection to be made successfully in most cases. If 
your connection needs parity, then set the appropriate kind. If you need to use 8-bit 
characters, be sure to read Chapter 9. 

SET TERMINAL CHARACTER-SET remote-cset [ local-cset ] 

Specifies the remote and local character sets so C-Kermit can translate between them 
during CONNECT sessions. The default terminal character-set is TRANSPARENT, which 
means that characters are not translated during terminal connection. This command 
and character sets in general are discussed in Chapter 9. 

SET TERMINAL ECHO { LOCAL, REMOTE } 

Tells whether C-Kermit should echo the characters you type locally (local) or let the 
remote computer echo them (remote). The default is remote except for telnet net¬ 
work connections, where it is LOCAL until and unless renegotiated by telnet protocol 
or overriden by a SET TELNET ECHO command (see Chapter 3). If characters don’t 
echo when you type them, you should SET terminal ECHO LOCAL. If characters echo 
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twice when you type them, then set terminal echo remote. The set duplex and 
SET LOCAL-ECHO commands perform the same functions as this command. 

SET TERMINAL LOCKING-SHIFT { ON, OFF } 

Tells whether C-Kermit should use Shift-In and Shift-Out control characters (Ctrl-N 
and Ctrl-O) for transmitting 8-bit characters on a 7-bit connection between C-Kermit 
and the remote computer during a CONNECT session (see Chapter 9 for a fuller discus¬ 
sion of this feature). This setting applies in both directions: to characters you type at 
the keyboard and to characters arriving from the remote computer or service. 

SET TERMINAL NEWLINE-MODE { ON, OFF } 

Tells whether C-Kermit should automatically convert carriage return (CR, ASCII 13) 
characters typed at the keyboard into carriage-retum-linefeed (CRLF, ASCII 13 and 
ASCII 10) combinations before transmission. Normally OFF. Don’t use this one un¬ 
less your coNNECT-mode screens look like they need it. The normal indications are 
that the remote host does not respond to your commands, or that your commands over¬ 
write one another. 


SET TERMINAL CR-DISPLAY { CRLF, NORMAL } 

This is like SET terminal NEWLINE-MODE, but in the opposite direction. It tells 
whether carriage return characters received from the communication device should be 
displayed as carriage return only (NORMAL, the default) or as carriage return and 
linefeed (crlf). Use the CRLF option when connected to a device that terminates its 
output lines with bare carriage returns. 


SHOW TERMINAL 

Displays your current terminal settings: 


C-Kermit >sho term 
Command bytesize: 7 bits 
Terminal bytesize; 7 bits 
Terminal echo: remote 
Terminal locking-shift; off 
Terminal newline-mode: off 
Terminal cr-display: cr-only 

Terminal character-set: transparent 
CONNECT-mode escape character: Ctrl-\ 
Suspend: on 
C-Kermit> 


(ASCII 28, FS) 


In this example, the SHOW TERMINAL display shows all the default terminal settings for 
UNIX C-Kermit. The Suspend: on line applies only to UNIX (see Appendix HI) and does 
not appear in other operating systems. 


90 Terminal Connection / Chapter 4 



Key Mapping 


C-Kermit can substitute any character or character string for any key that you press during 
a connect session. For keys that produce 7- or 8-bit codes, the default assignment for 
each key is itself, that is, the key transmits the code that it produces when you press it. 
You can use the following commands to change the default assignments. 

SHOW KEY 

This command tells Kermit to ask you to press a key. When you do, Kermit shows 
you the code value of the key and the key’s current definition. The codes and their 
character assignments are necessarily system-dependent. Here is an example using a 
NeXT workstation: 

C-Kermit> set command bytesize 8 
C-Kermit> show key 
Press key: Alt-s 

Key code \251 => Character: ft \251 (self, no translation) 

The user types Alt-s (holds down the Alternate key and presses the s key). On the 
NeXT, this produces “German sharp s” (8, Ess-Zet). 251 is the key code. It is shown 
in decimal. In most C-Kermit versions, only 7-bit or 8-bit code values are accessible. 
Under OS/2, additional codes are available for Alt, function, and arrow keys. 

SET KEY key-code [ definition ] 

This assigns the given definition to any (and all) key(s) that produce the given key 
code. The key-code may be a simple decimal number or a backslash code used to ex¬ 
press the number in decimal, octal, or hexadecimal notation (Table 1-2). Normally 
you would use the same notation for the key as SHOW KEY displays for it. The 
definition can be a single character, expressed literally (if possible) or in backslash 
notation, or a string of characters (possibly containing backslash codes). If the defini¬ 
tion is omitted, the key’s default definition is restored. Here are some examples, in 
which we assign various values to the NeXT Alt-s key: 


C-Kermit>set 

key 

\251 

\29 

(Ctrl-Rightbracket) 

C-Kermit>set 

key 

\251 

_x 

(The single character 'x') 

C-Kermit>set 

key 

\251 

ss 

(Double 's') 

C-Kermit>set 

key 

\251 

Oh my. 

this is a wordy keystroke I\13 

C-Kermit>set 

key 

\251 


(Restore default value) 


C-Keimit’s set key command has several restrictions: 

• To use 8-bit key codes, you must first set command bytes ize 8. The method for 
entering 8-bit characters depends on your computer, operating system, terminal 
emulator (if any), keyboard, and keyboard driver. 

• If you use set key to assign coNNECT-mode escape commands to single keys, the 
characters assigned to the key are transmitted, rather than treated as escapes. 
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• If you include a NUL (ASCII 0, \ 0) value in a key definition, it terminates the defini¬ 
tion, and the NUL character itself will not be transmitted when you press the key. 

A common use for the SET KEY command is to relocate inconveniently placed keys for 
easy typing. For example, some keyboards have the Esc (Escape) key far off in right 
field, out of reach, and the accent-grave (backquote) key where you want the Esc key to 
be. Use SET key to swap them: 

C-Kermit> set key \96 \27 
C-Kermit> set key \27 \96 

Another common use of SET key is to change what is sent by your backspace key. Some 
hosts expect DEL (Delete, ASCII 127), others expect BS (Backspace, Ctrl-H, ASCII 8). 
This example assigns ASCII BS to the NeXT’s backspace key, whose key code (and 
therefore default assignment) is 127: 

C-Kermit> set key \127 \8 
C-Kermit> set key \8 \127 

Here again, we swap keys. In case we actually have to transmit a real DEL, it is assigned 
to the Ctrl-H key. 

C-Kermit’s SET key assignments are effective only while the connect command is ac¬ 
tive. When you press a key that has been given a definition with SET KEY, all terminal and 
communication settings are applied to the characters in its definition before they are sent, 
just as if you had typed the characters on the keyboard during CONNECT mode. 

Logging and Debugging Your Terminal Session 

You can have C-Kermit copy all the characters that appear on your screen during a 
CONNECT session to a file called the session log. You can also make C-Kermit display 
control characters graphically rather than passing them directly to your terminal emulator 
or console driver. Here are the commands: 

LOG SESSION [ [ filename ] { APPEND, NEW } ] 

This command tells C-Kermit to copy the characters that are sent to your screen into 
the file whose name is given. If no name is given, Kermit creates a new file called 
SESSION. LOG in your current directory. The trailing keyword, APPEND or NEW, tells 
whether to write the session log to the end of an existing file or to create a new file. 

The default is new (in VMS and Open VMS, a new file version is always created). 
Characters are recorded in their 8-bit form if PARITY is NONE and TERMINAL BYTESIZE 
is 8. Otherwise only 7-bit characters are logged. If the terminal character set is not 
TRANSPARENT, the characters are recorded after translation. The SHOW FILE command 
displays the name of your current session log file. It is also shown in the CONNECT 
message and by the CONNECT-mode status-display request: 
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C-Kermit> log ses (Start a session log) 

C-Kermit> connect (Begin terminal connection) 

Connecting to /dev/ttyh8, speed 9600 

(Session logged to session.log, text) 

login: Ctrl-\S (Status request) 

Logging to: session.log 

CLOSE SESSION 

Terminates session logging and closes your session log file. The log file is also closed 
automatically when you exit from C-Kermit. 

SET SESSION-LOG { BINARY, TEXT } 

(UNIX and AOS/VS only) A binary-mode session log contains every character that is 
received from the remote computer, including NUL and DEL padding characters, as 
well as carriage returns. When the session-log type is TEXT, C-Kermit discards NUL, 
DEL, and CR characters, so the result is more likely to be usable as a UNIX or 
AOS/VS text file (this command has no effect in VMS, OS/2, or C-Kermit’s other 
operating systems), text is the default type of session log. 

SET DEBUG { SESSION, OFF } 

The SET debug SESSION command changes your cONNECT-mode screen into a kind of 
data analyzer. Control and 8-bit characters are displayed graphically. For example, 
Ctrl-A is displayed as "A, ESC is displayed as A [, etc. (see Table VIII-2). An 8-bit 
character is shown as a tilde (~) followed by the 7-bit version of the character, for ex¬ 
ample the letter A with its parity bit set looks like -A. On a network connection, 
TELNET protocol negotiations are displayed on the screen. Terminal character sets are 
not translated during session debugging. Session debugging is normally OFF. 


Here is an example of a debugging display on a telnet connection, in which both telnet 
negotiations and control characters are displayed symbolically: 


C-Kermit> set debug session 
C-Kermit>telnet foo.bar.com 


[WILL TERMINAL TYPE] [DO SUPPRESS GO AHEAD]<D0 TERMINAL TYPEXWIL 
L SUPPRESS GO AHEADXSB TERMINAL TYPE 01 IAC SE>[SB TERMINAL TYP 
E 00 VT300 IAC SE]<WILL ECHO>[DO ECHO]<DO ECHO> A M A J A M A JSunOS UNI 
X (watsun) A M A j~m a @ a M a J A M A 01ogin: olaf A M A JPassword: A M A JLast login 
: Sat Jul 4 16:20:45 from watsun A M A JSunOS Release 4.1.1 (WATSUN 
) #1: Mon Sep 23 20:11:19 EDT 1991 A M A J A M A J A [[ 1 ; 24r A [[ 24 ;lH A M A @We 
lcome to /dev/ttyp6 A M A J$ exit A M A J[WONT ECHO]<DONT ECH0> 


The TELNET options that Kermit sends are enclosed in square brackets and the ones it 
receives are enclosed in angle brackets. A [[l;24r A [[24;lHisa screen setup command 
for a VT terminal. A M A J is a carriage return and linefeed sequence, and A @ is a NUL. 
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Chapter 5 


The Basics of File Transfer 


OOOO 

This chapter explains the basic method for transferring ordinary text and binary 
files using the Kermit protocol. If you encounter difficulties, read Chapter 6 to 
learn how to solve them. If you need to transfer text files containing national or 
international characters, also read Chapter 9. VMS and Open VMS users who 
need to cope with special file formats also should read Appendix IV. To trans¬ 
fer files with other computers or services that do not have Kermit file transfer 
available, consult Chapter 10. After you have mastered basic file transfer, you 
can stop reading for a while. Later, when you find yourself wanting easier or 
faster ways to transfer data, read Chapters 7 and 8. And if you want to automate 
yourself out of business, read about script programming in Chapters 11-13. 


Basic File Transfer Commands 


The Kermit protocol transfers files from one computer to another and it requires Kermit 
software on both computers. Kermit programs communicate with each other using for¬ 
matted messages called packets. If packets are lost, duplicated, or damaged during trans¬ 
mission, the receiving Kermit notifies the sending Kermit and corrective action is taken 
automatically to ensure your files are transferred without error. For a detailed description 
of the Kermit protocol, see the book Kermit, A File Transfer Protocol [18]. We assume 
you understand the terms “local computer” and “remote computer,” and you are able to 
connect your local computer to the remote one with Kermit communications software. If 
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Table 5-1 Special Characters in C-Kermit File Specifications 


Field or Pattern 

UNIX 

VMS 

AOS/VS 

OS/2 

OS-9 Amiga 

Atari 

Username 

- 




- 

- 

The directory separator 

/ 

t • ) 

: 

\ or / 

/ / 

\ 

The current directory 

• 

U 

= 

• 

• 

• 

The superior directory 


- 



/ 

• • 

* Inferior directories 


— 

* 




* Any string of characters 

* 


+ 


* * 


* Any string not containing 


* 

- 

* 


•k 

* Any single character 

? 




? ? 


* Any character but 


% 

* 

? 


? 

* Any character from a set 

[ abc ] 







[a-z] 






* Any string from a set 

{foo,bar> 






* Exception string 



\ 





necessary, please review Chapter 3 or consult the documentation for your local Kermit 
program if it is not C-Kermit. 

The basic file transfer commands are SEND and RECEIVE. One computer’s Kermit must be 
told to send a file and the other computer’s Kermit program must be told to receive it. 

The SEND Command 

SEND filespec 

The SEND command sends the file or files denoted by filespec to the Kermit program 
on the other computer, which must be given a receive command. 

The filespec is allowed to contain “wildcard” characters to send all the files whose names 
match. A wildcard is a special character used in a filename to denote a group of files 
whose names match a given pattern. Wildcards are also called metacharacters (in UNIX) 
or templates (in AOS/VS). Wildcard syntax can vary from system to system. Table 5-1 
gives a summary of special characters that can be used in filenames on systems supported 
by C-Kermit; the items marked by asterisk (*) in the first column are considered wild¬ 
cards. Consult the system-specific appendices of this book for details. 

The name of each file, converted to uppercase if necessary, is transmitted to the receiving 
Kermit program so the file can be stored with its own name automatically when it arrives. 
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SEND can be abbreviated to the single letter S, even though other C-Kermit commands 
begin with S. Examples: 

C-Kermit> send oofa.txt (A single file) 

C-Kermit> sen oofa.+ (All AOS/VS oofa files) 

C-Kermit> sen oofa.* (All oofa files, other systems) 

C-Kermit> s \?\? (UNIX files with 2-char names) 

C-Kermit> s %% (VMS files with 2-char names) 

The default directory for filenames is the one where you started C-Kermit or the one given 
in the most recent CD command. You can include disk and/or directory information in the 
filespec for files that are not in your current directory. During transmission, filenames are 
stripped of any device, directory, or version information. For example, when the follow¬ 
ing file is sent by VMS C-Kermit: 

C-Kermit> send $diskl:f olga ] login.com;5 
the receiver is told that its name is simply LOGIN. COM. 

The RECEIVE Command 

RECEIVE [filename ] 

The RECEIVE command tells C-Kermit to wait for one or more files to arrive from the 
other Kermit program, which must be given a SEND command. 

Incoming filenames are converted to the format of C-Kermif s underlying operating sys¬ 
tem; for example, UNIX C-Kermit converts uppercase letters in the filename to lowercase. 
If the incoming filename includes a device or directory, C-Kermit tries to store the file 
there. The RECEIVE command can be abbreviated by the single letter R. Examples: 

C-Kermit> receive (Receive one or more files) 

C-Kermit>r (Receive one or more files) 

If the optional filename is included, the arriving file is stored under that name rather than 
the name it was sent with: 

C-Kermit> receive oofa.txt (Store incoming file as oofa.txt) 

The “as-name” can include disk and directory information so you can store the incoming 
file somewhere other than your current directory, and it can also denote a device such as a 
printer if your operating system allows. It may not contain wildcard characters. If more 
than one file arrives, only the first one is renamed; the rest are stored under their own 
names. UNIX creates the file with the as-name just as you typed it, but VMS, OpenVMS, 
AOS/VS, and other systems create the file with an uppercase name even if you typed it 
with lowercase letters. 

The receive command requires that you have write access to the device and directory in 
which the arriving file is to be stored. C-Kermit will not create files for you that you 
could not otherwise create yourself. 
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Other Commands for Sending Files 

A variation on the send command lets you supply a list of files to be sent, rather than just 
one file specification: 

MSEND filespec [ filespec [ ... ] ] 

Multiple Send. This command sends all the files in the list in a single operation, so 
you only have to give one receive command to the other Kermit. The names are 
separated by spaces. Each file is sent under its own name. Each item in the list can be 
the name of a single file or a wildcard file group specification. The files can be on dif¬ 
ferent devices and in different directories. Examples: 

C-Kermit> msend oofa.txt oofa.new (Two files or...) 

C-Kermit> mse ~olga/*.c -olaf/*.h (from different directories) 
C-Kermit> ms rolga1*.c [ivan]*.h (Ditto, VMS and OpenVMS) 
C-Kermit> ms ckc*.c cku*.c ckw*.c ck*.h makefile 

A final variation on the send command lets you send a single file under an assumed 
name: 

SEND filename [ remote-filename ] 

Sends the file specified by filename, which must not contain wildcards, transmitting it 
under the name remote-filename. Example: 

C-Kermit> 3end niqht.txt day.txt 

This sends the file night. txt but tells the receiving Kermit that its name is 
day. txt. The remote-filename field should be a filename in the syntax of the remote 
computer. It can contain any printable characters, even spaces. C-Kermit does not 
(and can not) check it for syntax, and does not convert it in any way. If you do not 
supply a remote-filename field, the file is sent with its own name. 


Easy File Transfer Examples 

Let’s introduce two new words, illustrated in Figure 5-1: upload and download. Upload 
means to send a file from your local computer to the remote computer. Download means 
to transfer a file from the remote computer to your local computer. 

All Kermit programs are set up to transfer ordinary 7-bit US ASCII text files unless you 
say otherwise, so let’s begin by doing that. The procedure for uploading is: 

1. Start Kermit on your local computer. 

2. Make a connection to the remote computer. 

3. CONNECT to the remote computer and log in. 

4. Start Kermit on the remote computer and tell it to RECEIVE the desired file. 
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5. If necessary, escape back to Kermit on the local computer. 

6. Tell the local Kermit to send the file. 

7. Watch the file transfer display. 

8. Wait for the beep or message that says the transfer is complete. 

9. connect back to the remote computer, conduct any further business you might have 
there, and then log out from it when you’re finished. 

10. Escape back to your local Kermit (if necessary) and exit from it. 


In our first example, shown in Figure 5-2, you are sitting at a PC equipped with MS-DOS 
Kermit. You will connect to a VAX computer over a direct line and upload a file to 
C-Kermit on the VAX. 


C;\ >kermit 

MS-Kermit> set speed 9600 
MS-Kermit>connect 

Username: olqa 
Password: 


(Start Kermit on the PC) 
(Set the desired speed) 
(Begin terminal emulation) 

(Log in on the VAX) 

(Type your password) 


$ kermit (Start Kermit on the VAX) 

C-Kermit 5A(188), 23 Nov 92, OpenVMS VAX 
Type ? or HELP for help 

C-Kermit >receive (C-Kermit receives the file) 

Return to your local Kermit and give a SEND command. 


KERMIT READY TO RECEIVE... 
Alt-X 

MS-Kermit> send autoexec.bat 
(The file is transferred...) 
MS-Kermit> 


(Escape back to the PC) 

(Hold down Alt key and press X) 
(Tell the PC to send the file) 


(Beep, all done) 


Presto, the file is transferred. Notice that you only have to tell the sending Kermit the 
name of the file to be sent. It tells the receiving Kermit so the file is automatically stored 
with the right name. For completeness, let’s go back to the VAX and properly finish our 
session: 


MS-Kermit>connect 

C-Kermit> dir /size/date autoexec 

Directory $DISK1:[OLGA] 

AUOTEXEC.BAT;1 3 31-DEC-92 23 

C-Kermit> exit 

$ logout 

Alt-X 

MS-Kermit>exit 

C:\> 

Now you’re back where you started. 


(Connect back to the VAX) 

(Is the file really there?) 

i:59 

(Exit from C-Kermit on the VAX) 
(Log out from the VAX) 

(Escape back to the PC) 

(Exit from MS-DOS Kermit) 

(Back to the DOS prompt) 
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Remote MV System 



HINT: If the file transfer didn’t work, it’s probably because of a communication 
parameter called parity. Try giving the command: 

C-Kermit> set parity even 

(or SET PARITY SPACE) to C-Kermit before you give the SEND command, escape 
back, and give the same set command to your local Kermit before giving the 
receive command. We’ll cover parity and other difficulties in Chapter 6. 


Downloading 

Downloading is just like uploading, except with the send and receive commands ex¬ 
changed. In this example, illustrated in Figure 5-3, we connect from a desktop CP/M 
microcomputer to a remote Data General MV AOS/VS system. The micro is the local 
computer, the MV is the remote, and they have a direct connection: 


B> a:kermit 
Kermit-80 v4.11 
Kermit-80> set speed 9600 
Kermit-80>connect 
Username: ivan 

Password: _ 

) kermit 

C-Kermit 5A(188), 23 Nov 92, 
Type ? or HELP for help 
C-Kermit> 


(Start Kermit on the micro) 

(Set the desired speed) 

(Begin terminal emulation) 

(Log in to the MV system) 

(Type your password) 

(Start Kermit on the MV system) 

AOS/VS 


(AOS/VS C-Kermit prompt) 
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C-Kermit >send login.cli (C-Kermit sends the file) 

Return to your local Kermit and give a RECEIVE command. 


KERMIT READY TO SEND... 

Ctrl- ]C 
Kermit-80> rec 

(The file is transferred...) 

Kermit-80> 

Kermit-80 >dir login 
LOGIN CLI 3 
Kermit-80> 


(Escape back to the micro) 
(The micro receives the file) 


(Beep, finished) 
(Check it) 


See, the file is really on your micro’s disk, stored automatically under the correct name. 
Now connect back to the remote computer, finish your session, and log out: 


Kermit-80>c 
C-Kermit> exit 
) bye 
Ctrl-1C 
Kermit-80> 


(Connect back) 

(Exit from C-Kermit) 
(Log out from AOS/VS) 
(Escape back) 


What Are Those Squiggles? 

When you give the SEND command to the remote Kermit, as in the previous example, it 
waits for a few seconds to give you time to escape back to the local Kermit program and 
issue a RECEIVE command. Then it sends its first file transfer packet. The normal waiting 
time is about 5 seconds. If you fail to escape back quickly enough, you will see the first 
packet on your screen, looking something like this: 16 

C-Kermit> send oofa.txt 

Return to your local Kermit and give a RECEIVE command. 

KERMIT READY TO SEND... 

A A0 Sz* @-#Yl~* yE 

No harm is done; you have about a full minute to escape back and engage the receiving 
Kermit before the remote Kermit loses patience and returns to its prompt. But if you are 
disconcerted by the appearance of this packet on your screen, you may lengthen the delay 
interval: 

SET DELAY number 

Tells C-Kermit how many seconds to wait before sending its first packet after it has 
been given a send command, when it is in remote mode. Example: 

C-Kermit> set delay 10 


16 If you have given a receive command and did not escape back fast enough, you will see a packet that 
looks like this: “# N3”. 


102 The Basics of File Transfer / Chapters 



Once you have become highly dextrous and proficient at escaping back and typing 
receive, the normal 5-second hiatus can be surprisingly annoying, so you can also short¬ 
en C-Kermit’s waiting time: 

C-Kermit> set delay 1 

The SET delay command has no effect when receiving files, or when uploading files from 
C-Kermit on your local computer. 


Network File Transfer 

If you are accessing the remote computer with a true high-speed network connection, 
C-Kermit works the same as in the previous examples, but much faster. In this example 
we access a UNIX host computer via a TCP/IP Ethernet connection from MS-DOS Ker- 
mit on a PC and download a file: 


MS-Kermit> set port tcp kermit.cc.columbia.edu 
MS-Kermit>connect 


logins olaf 
Password: _ 

$ Kermit (Start UNIX Kermit) 

C-Kermit 5A(188), 23 Nov 92, SunOS 4.1 
Type ? or HELP for help 


C-Kermit> send mailing.1st 
Alt-X 

MS-Kermit>r 

(The file is transferred...) 

MS-Kermit>c 
C-Kermit> exit 
$ exit 

If the file transfer failed, SET parity to 
(on other types of connections), and start 


(Send a file) 

(Escape back to the PC) 
(Receive the file) 


(Connect back to UNIX) 

(Exit from C-Kermit) 

(Log out from UNIX) 

PACE (for TELNET), or to MARK, EVEN, or ODD 
ie file transfer again. 


File Transfer through Terminal Servers 

If you have made a serial connection to a terminal server or similar device that makes a 
network connection to the computer where C-Kermit resides, the host operating system 
probably does not know your true connection speed, and therefore neither does C-Kermit. 
For example, suppose you have dialed up a terminal server at 2400 bps and then used it to 
access a UNIX host computer. The host computer probably thinks your speed is much 
higher, most likely 38400 bps. 17 Kermit uses the host computer’s idea of the speed to cal¬ 
culate its packet timeouts, so you should be sure the host computer knows your true con¬ 
nection speed before you start C-Kermit, or file transfer might fail: 


17 This is the speed that most UNIX hosts associate with /dev/tty when it is not a real terminal device. 
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$ stty 2400 

$ set terminal /speed=2400 


(UNIX) 

(VMS and OpenVMS) 


Here is an example in which we use MS-DOS Kermit to dial up a terminal server, connect 
from there to an IBM RS/6000 host, and then transfer a file from the PC to the RS/6000: 


C:\> kermit 

MS-Kermit >set speed 2400 
MS-Kermit> dial 7654321 
MS-Kermit>connect 


(Start Kermit on the PC) 
(Set the desired speed) 
(Dial the terminal server) 
(Begin terminal emulation) 


Please enter a hostname 


(Terminal server greeting) 


Hostname? unixa 
Trying UNIXA... 


(Specify hostname) 
(Connection is established) 


Welcome to UNIXA. AIX 3.2 (UNIX greeting) 


login: ivan 
Password: 


(Log in to UNIX) 
(Type your password) 


$ stty 2400 (Before starting C-Kermit!) 

$ 

$ kermit (Start Kermit on UNIX) 

C-Kermit 5A(188), 23 Nov 92, IBM RS/6000 
Type ? or HELP for help 

C-Kermit> receive (C-Kermit receives the file) 

Return to your local Kermit and give a SEND command. 


KERMIT READY TO RECEIVE... 
Alt-X 

MS-Kermit> send read.me 

(The file is transferred...) 
MS-Kermit> 


(Escape back to the PC) 

(MS-DOS Kermit sends the file) 


(All done) 


Local-Mode File Transfer 


In this example, you are running C-Kermit on your local computer, a UNIX workstation 
or timesharing system, and you are dialing up a remote computer to download some files. 
Note the use of the wildcard character * to denote a file group. 


$ kermit 

C-Kermit 5A(188), 23 Nov 92, 
Type ? or HELP for help 
C-Kermit> set modem hayes 
C-Kermit> set line /dev/ttyh8 
C-Kermit> set speed 2400 
C-Kermit> dial 5551234 
Connection completed. 


(Start Kermit on UNIX) 
SunOS 4.1 

(Specify modem type) 

(and communication device) 
(and speed) 

(Dial the number) 

(Call completed) 
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C-Kermit> connect (Begin terminal emulation) 

Connecting through /dev/ttyh8, speed 2400. 

The escape character is Ctrl-\ (ASCII 28, FS). 

Type the escape character followed by C to get back, 
or followed by ? to see other options. 

ELECTRO-BRAIN 9000 

LOGIN: olaf (Type your username) 

PASSWORD: _ (and your password) 


WELCOME. CHOOSE: 

1. Chess 

2. World Domination 

3. Kermit 

4. Logout 

(Kermit, of course) 

(Send some files) 

(Escape back to C-Kermit) 
(Receive the files) 

(The files are transferred...) 


YOUR CHOICE? 3 

Electro-Kermit> send plan*.txt 
Ctrl-\c 

C-Kermit>receive 


C-Kermit> connect (Go back to the remote computer) 

Electro-Kermit >exit (Exit from the remote Kermit) 

YOUR CHOICE? 4 (Log out) 

ELECTRO-BRAIN 9000 HAS TERMINATED YOUR SESSION. 

GOOD BYE. 

Communications disconnect (back at local system) 

C-Kermit> dir plan*.txt (List the received files) 


-rw-rw- 1 olaf 

-rw-rw- 1 olaf 

-rw-rw- 1 olaf 


42378 Aug 
5986 Aug 
12873 Aug 


8 19:21 planl.txt 
8 19:21 plan2.txt 
8 19:21 plan3.txt 


C-Kermit> exit (Exit from C-Kermit) 

$ 


Here is another example, in which you use C-Kermit to make a TCP/IP TELNET connec¬ 
tion to a remote Internet host and upload some files to it. Both computers have C-Kermit, 
so you take advantage of the set prompt command to keep yourself oriented: 


C-Kermit> set prompt Local> 
Local> telnet hq 

login: olaf 
Password: 


$ kermit 

C-Kermit 5A(188), 23 Nov 92, 
Type ? or HELP for help 
C-Kermit> set prompt Remote> 
Remote>r 
Ctrl -\c 


(Prompt for local Kermit) 
(Go to the remote host) 

(Log in) 

(Enter your password) 


(Prompt for remote Kermit) 
(Receive some files) 

(Escape back to local C-Kermit) 


(Start Kermit on remote computer) 
HP 9000 Series HP-UX 


Local-Mode File Transfer 105 



Local>s /usr/include/t*.h 


(Send some files) 


(The files are transferred...) 

Local>c (Connect back to remote computer) 

Remote> exit (Exit from remote Kermit) 

$ exit (bog out from remote computer) 

Communications disconnect (back at local system) 

Local> 


The File Transfer Display 

When C-Kermit is used in local mode, it displays the progress of the file transfer on your 
screen in one of several formats: fullscreen, serial, crt, or none at all. The command to 
select the display style is: 

SET FILE DISPLAY { CRT, FULLSCREEN, NONE, SERIAL } 

The default type of display is serial. 

The FULLSC RE EN display, available in VMS, Open VMS, OS/2, OS-9, Amiga, and most 
UNIX C-Kermit versions, produces a formatted report on a 24-line by 80-column screen: 


C-Kermit 5A(188), 23 Nov 92, MYVAX 


Current Directory 
Communication Device 
Communication Speed 
Parity 

Sending 
File Type 
File Size 
Percent Done 
Estimated Time Left 
Window Slots 
Packet Type 
Packet Count 
Packet Length 
Packet Retry Count 
Packet Block Check 

Last Error 
Last Message 


$DISK1s[OLAF.TMP] 

_TXA5 s 

2400 

none 

OOFA.TMP;6 => OOFA.TMP => oofa.tmp 

text 

40918 

39 

00:01:44 
3 of 4 
D 
20 

1000 

1 

2 


X to cancel file, Z to cancel group, <CR> to resend packet, 
E to send Error packet, or Ctrl-C to quit immediately. 


The fields on the right are updated continuously to keep you informed of the progress of 
the transfer. The top line shows the Kermit version number, release date, and the name of 
your local computer (if known). The estimated time remaining to transfer the current file 
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is updated continuously and can fluctuate as the speed of the transfer changes. The 
“Sending” line shows the local filename, the name used in the packet, and the name used 
on the remote computer. At the end of a successful transfer, the Last Message field 
changes to a summary report, a beep is sounded, and the C-Kermit prompt reappears: 


Last Error: 

Last Message: Files: 4, Total Bytes: 1432371, 229 cps 
C-Kermit> 


“cps” means characters per second, an indication of the efficiency of the file transfer (dis¬ 
cussed more fully in Chapter 8). To check whether the fullscreen display is available: 

C-Kermit> check fullscreen 
Available 
C-Kermit> 

Even when available, the fullscreen display won’t work if your terminal type is set incor¬ 
rectly or is not supported. 

The SERIAL file transfer display, which is used unless you specify otherwise, works with 
all kinds of display devices, including video and hardcopy terminals as well as Braille and 
speech units. It looks like this: 


SF 

X to cancel file, CR to resend current packet 
Z to cancel group, A for status report 
E to send Error packet, Ctrl-C to quit immediately: 
A 

Receiving: PLAN1.TXT => planl.txt 
Size: 8113, Type: text 

.Z [OK] 

F A 

Receiving: PLAN2.TXT => plan2.txt 
Size: 12341, Type: text 
••••••••••T%..N%..Z [OK] 

F A 

Receiving: PLAN3.TXT => plan3.txt 
Size: 10001, Type: text 

.Z [OK] 

B 


The single letters like S, F, A, Z, and B are Kermit protocol packet types, listed in Table 
5-2 on the next page. If there is any information to report, it is shown after the packet let¬ 
ter. For example, after the F packet, C-Kermit reports the file name, such as plani.txt. 
When the A packet arrives, which contains the file’s size, C-Kermit shows the reported 
size. => planl. txt shows the local name for file. 
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Table 5-2 Kermit Packet Types 


Type 

Name 

Function 

A 

Attributes 

Attributes of file. 

B 

Bye 

End of transmission. 

C 

Command 

Host command for a server. 

D 

Data 

Data from file. 

E 

Error 

Fatal error, contains message. 

F 

File Header 

Start of file, contains filename. 

G 

Generic 

File management command for a server. 

I 

Information 

Protocol parameters. 

N 

NAK 

Negative acknowledgement, requests retransmission. 

R 

Receive Initiate 

Asks server to send a file. 

S 

Send Initiate 

Negotiates parameters and starts sending. 

T 

Timeout 

(Pseudopacket) Indicates a timeout waiting for a packet. 

Y 

ACK 

Acknowledgement. 

Z 

End of File 

Tells receiver to close the file. 

X 

Text Header 

Precedes screen data. 

% 

Retransmission 

(Pseudopacket) Indicates that a packet was retransmitted. 


When the file starts to arrive, C-Kermit prints a period for every K (1024 characters) of 
data successfully received. If an expected packet does not arrive within a per-packet 
timeout interval, a T is printed. If a negative acknowledgement is sent or received, an N is 
printed. If a packet is retransmitted, a percent sign (%) is displayed. 

If FILE DISPLAY is set to CRT, the dots are replaced by a line continuously showing the 
bytes (characters) transferred so far, the percentage done, the current transfer rate in 
characters per second (CPS), and the length of the current packet. This line is refreshed 
by simple overstriking, and so should work on any CRT (video) terminal: 


Sending: ckuxla.h => CKUXLA.H 
Size: 2599, Type: text 

File Percent Packet 

Bytes Done CPS Length 

2599 89% 229 998 


When file display is OFF, C-Kermit skips the display and transfers files silently. The 
file-transfer interruption characters (X, Z, E) are disabled, but you can still get back to the 
C-Kermit prompt by typing Ctrl-C. The file transfer display is turned off automatically if 
C-Kermit is transferring files in the background. 
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Interrupting a File Transfer 


While files are being transferred, you can interrupt the transfer or query its progress. This 
is done from the local Kermit program by pressing a key, a key combination, a sequence 
of keys, or, in some cases (as in Macintosh Kermit), a mouse button. 

When C-Kermit is the local Kermit program, in most cases you need only type a single 
key, such as X. In others, notably those based on AT&T System V UNIX, you must type 
the CONNECT-mode escape character (normally Ctrl-Backslash) before you type the inter¬ 
ruption key. 18 

C-Kermit’s file transfer interruption keys are available to you when C-Kermit is in local 
mode and its file transfer display is active. When the file transfer begins, C-Kermit tells 
you what the available interruption keys are. In most C-Kermit versions, the message 
looks like this: 

X to cancel a file, CR to resend current packet 
Z to cancel group, A for status report 
E to send Error packet, Ctrl-C to quit immediately. 

In versions that require you to type the CONNECT-mode escape character before the inter¬ 
ruption key, the message might look like this: 

Type escape character (*\) followed by: 

X to cancel a file, CR to resend current packet 
Z to cancel group, A for status report 
E to send Error packet, Ctrl-C to quit immediately. 

or like this: 

<~\>X to cancel file, <*\>Z to cancel group, < A \><CR> to resend packet, 
<'\>E to send Error packet, or Ctrl-C to quit immediately. 

Most of the interruption keys also have control-character equivalents and possibly other 
synonyms. For example, to interrupt transfer of a single file, you can type X, F, Ctrl-X, or 
Ctrl-F. The X or F can be either upper- or lowercase. 

The same interruptions can be sent to a remote C-Kermit program from your local PC, 
Macintosh, or other Kermit program. They work the same way, but you might have to 
enter them differently; for example, the Macintosh Kermit file transfer display has inter¬ 
ruption boxes that you can click on with your mouse. Consult the documentation for your 
local Kermit program. 


18 The control-character prefix is required because of limitations in the System V terminal driver. 
Nevertheless, certain System-V based C-Kermit versions include a workaround, so also try entering the 
interruption characters without the control-character prefix. 
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Cancelling a Single File: X 

The X key (or, if required, escape-character followed by X) cancels the file currently be¬ 
ing transferred. If a group of files is being sent, Kermit skips ahead to the next one. 

C-Kermit> s ckuusr.* 

SF 

X to cancel file, CR to resend current packet 
Z to cancel group, A for status report 
E to send Error packet, Ctrl-C to quit immediately: 

A 

Sending: ckuusr.c => CKUUSR.C, 

Size: 41152, Type: text 
.X 

Cancelling File [discarded] 

FA 

Sending: ckuusr.h => CKUUSR.H 
Size: 17773, Type: text 

.Z [OK] 

C-Kermit> 

If C-Kermit is sending a file, it tells the remote receiver to close and discard the file. If 
C-Kermit is receiving a file, it tells the sender to cancel the transfer, then closes and dis¬ 
cards the portion of the file received so far. 

Cancelling a Group of Files: Z 

If you type Z instead of X and more than one file is being transferred, the entire file group 
is cancelled and C-Kermit should return to its prompt. If only one file is being transferred, 
Z works exactly like X. 

Retransmitting a Packet: Carriage Return 

If the file transfer appears to be stuck, you can type a carriage return (press the Return or 
Enter key) to resend the most recent packet. This does no harm because packets are num¬ 
bered and duplicates are automatically discarded. 


Requesting a Status Report: A 

If you type the letter A, C-Kermit prints a brief summary of how the transfer has 
progressed so far, then continues with the transfer: 


.A 

Status report: 
file type: text 
file number: 1 
size: 50532 

characters so far: 20761 
percent done: 41 


block check: 1 
compression: 1 
8th-bit prefixing: 
packet length: 89 
window slots: 1 
... [OK] 


0 


The A command is ignored if you are using the fullscreen file transfer display, since 
most of this information is already on the screen. 
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Suspending C-Kermit: Ctrl-Z 

On UNIX computers with job control, you can type Ctrl-Z to suspend Kermit during 
local-mode file transfer in such a way that the file transfer can be continued in either the 
foreground or the background. See Appendix III for details. 

Interrupting C-Kermit: Ctrl-C 

You can always type Ctrl-C to interrupt any file transfer. In local mode you only need to 
type one Ctrl-C to get back to the prompt immediately. A remote mode C-Kermit can be 
returned to its prompt by typing two Ctrl-C’s in a row: 

C-Kermit> send me.away (Send a file) 

A A0 Sz* @-#Yl~* yE (See the Kermit packet) 

Ctrl-C Ctrl-c (Type two Control-C's) 

*C... (Kermit confirms that it got them) 

C-Kermit> (and returns to its prompt) 

When you interrupt a local-mode file transfer with Ctrl-C, no protocol messages are sent 
to the remote Kermit (if any), and it remains in packet mode. Therefore, use this method 
only as a last resort or if you forgot to start the Kermit program on the other end. 

Sending an Error Packet: E 

You can cancel any kind of transfer and put the remote Kermit back into a known state by 
typing the letter E (or escape-character followed by E) while your file transfer display 
screen is active. This makes C-Kermit send an error (E) packet. 

This is useful, for example, if the remote Kermit does not respond to the X or Z cancel¬ 
lation messages; most popular Kermit programs do (see Table 1-1 on page 8). If the 
remote Kermit was started interactively and was given a send or receive command, the 
error packet should make it return to its prompt. If the remote Kermit is in server mode 
(explained in Chapter 7), the error packet makes it ready to receive a new command. 

You can also send an error packet by issuing the following command at the C-Kermit 
prompt or from a command file: 

E-PACKET 

Send an Error packet to the other Kermit. Example: 

C-Kermit> e-packet (Send an error packet) 

This command is useful when you mistakenly type Ctrl-C to interrupt a local-mode file 
transfer. If C-Kermit is not in local mode, the error packet appears on your screen con¬ 
taining the text “User cancelled.” It does no harm. 
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Transferring Text Files 


oooo 

Transfer of text files that contain accented letters, non-Roman letters, or other 
national or international characters is described in Chapter 9. 

OOOO 

The VMS and Open VMS file system is far more complex than the simple model 
presented here, and VMS C-Kermit’s handling of the VMS file system is quite 
different. VMS C-Kermit users should be sure to read Appendix IV in addition 
to this and the next few chapters. 

A text file is one that you can read on your screen without using any special kind of for¬ 
matting software such as a word processor or electronic publishing package. If you can 
display a file with your computer’s TYPE (or equivalent) command and it looks right, then 
it’s most likely a text file. 

Text files are made up of lines containing ordinary printable characters such as letters, 
digits, spaces, and punctuation marks, without special effects like boldface and italics. 
Different computers have different ways of representing text files: different codes to 
represent the characters (the character set) and different ways of separating the lines (the 
record format). On an ASCII-stream-based file system, for example, text files are 
generally made up of ASCII (or national or international) printing characters, with lines 
separated by carriage return, linefeed, or both, and containing no other control characters 
or formatting codes except perhaps for tab, backspace, and formfeed. 

Kermit automatically converts ordinary text files into a useful and appropriate format 
when you transfer them between unlike computers. It does this by using a standard 
representation for text within its file transfer packets, which is normally ASCII (ISO 646 
USA version) character codes (listed in Table VIII-1 on page 461) with Carriage-Return 
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Linefeed (CRLF) line terminators. The sending Kermit translates from the local compu¬ 
ter’s text file conventions to this form, and the receiving Kermit converts back to its own 
local conventions, as in the example shown in Figure 5-4. 

No special commands are needed to take advantage of Kermit’s text file conversion. It 
happens automatically unless you say otherwise. To be certain that Kermit will transfer 
files in text mode, however, you can use this command: 

SET FILE TYPE TEXT 

Tells Kermit to perform character set and record format conversions during file trans¬ 
fer, storing files in conventional and useful text format on the receiving computer. 

This is Kermit’s default file transfer mode. 


Transferring Binary Files 


Files that are not text files are called binary files. Our own peculiar definition of a binary 
file is a file that is not to be converted in any way during transfer. A good example would 
be an executable program image. Kermit does not know and cannot guess (except on 
VMS and Open VMS) which files you want converted and which ones you don’t. You 
must tell it. The command is: 

SET FILE TYPE BINARY 

This command tells Kermit that no conversions of any kind are to be performed upon 
the file during transfer. 


Let’s look at an example of binary file transfer in which we upload a copy of a PC ZIP ar¬ 
chive to a UNIX computer, making it available for other people to download to their PCs: 


C>kermit 

MS-DOS Kermit 3.11 
Type ? or HELP for help 
MS-Kermit >dir oofa.zip 
OOFA ZIP 192488 

MS-Kermit> set speed 2400 
MS-Kermit >dial 555-1234 
MS-Kermit>connect 


login: olaf 
Password: 


(Start Kermit on the PC) 


(Check the file's size) 
2-08-92 3:28p 

(Set the dialing speed) 
(Dial the UNIX computer) 
(Begin terminal emulation) 
(Press Enter to begin) 
(Type your username) 

(and password) 


Welcome to UNIX. 


$ kermit (Start C-Kermit) 

C-Kermit 5A(188), 23 Nov 92, UNIX System V R4 
Type ? or HELP for help 

C-Kermit> set file type binary (Use BINARY mode) 

C-Kermit> receive (Tell C-Kermit to receive the file) 
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Alt-X 


_ (Escape back to MS-DOS Kermit) 

MS-Kermit> set file type binary (Use BINARY mode) 

MS-Kermit> send oofa.zip (Send the file) 

(The file is transferred...) 

MS-Kermit> connect (Connect back to UNIX) 

C-Kermit> dir oofa.zip (Check file file's size) 

-rw-rw-r— 1 olaf 192488 Feb 8 13:28 oofa.zip 

C-Kermit> 

The two directory listings show that the received file on UNIX is exactly the same size as 
the original, which is a good indication that no conversions have taken place. 

To download the file from UNIX, follow the same procedure, but give a SEND command 
to UNIX C-Kermit first and then a RECEIVE command to MS-DOS Kermit: 

C-Kermit >set file type binary (Use binary mode) 

C-Kermit >send oofa.zip (Tell C-Kermit to send the file) 

Alt-x (Escape back to the PC) 

MS-Kermit> set file type binary (Binary mode here too) 
MS-Kermit> receive (Tell MS-DOS Kermit to receive) 

It is not always necessary to give the SET FILE TYPE command to both Kermit programs. It 
is often sufficient to give it only to the sender, and then the sender informs the receiver of 
the file type automatically by means of an attribute packet , explained in Chapter 8. At¬ 
tribute packets are an optional feature of the Kermit protocol, and are not supported by all 
Kermit software programs (see Table 1-1 on page 8). 


File Names 


Kermit transfers not just a file’s contents, but also its name. By default, file names are 
converted to a simple standard form on the assumption that the file is being transferred to 
a computer that has different file naming conventions. Kermit’s normal form for names 
should be inoffensive enough to agree with all kinds of computers. You can alter 
Kermit’s treatment of file names with the set file names command: 

SET FILE NAMES CONVERTED 

When sending files, C-Kermit translates the file name into uppercase if necessary and 
ensures that there is no more than one dot (period) in it. Extra dots or unusual charac¬ 
ters like spaces or punctuation are translated to X or underscore (_) and if a dot is the 
first character, an X is placed in front of it. In addition, all device, directory, and path 
names, as well as version numbers, are removed. For example: 

The file : Is sent as : 

OOfa.txt OOFA.TXT 

/usr/olga/oofa. txt OOFA.TXT 

$DISK1:[OLGAJOOFA.TXT;3 OOFA.TXT 
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oofa.txt.new 
oofa.txt.~3~ 
.login 


OOFA.TXTXNEW 
OOFA.TXTXX3 X 
X.LOGIN 


When receiving files, UNIX C-Kermit converts the name to lowercase, but does not 
alter it otherwise. Other C-Kermit implementations attempt to use the incoming 
filename as is. 

SET FILE NAMES LITERAL 

Leave file names alone. Do not change the case of letters, do not remove extra dots, 
do not strip device, directory, or path names, and do not strip version numbers. This 
option should be used only between like operating systems, and then only when they 
have the same directory structure and you have the appropriate access to the specified 
directories. 


In both cases, if an incoming filename contains device, directory, or version information, 
C-Kermit attempts to use it. For example, suppose you want to send a file from UNIX to 
a particular device and directory on VMS or Open VMS. If you give this command to 
send the file: t 

C-Kermit >send oofa.txt $diskl:[olga.new1oofa.txt;7 

VMS C-Kermit attempts to store the file on the given device in the given directory, with 
the given name and version number. If the device or directory doesn’t exist or you don’t 
have write access to them, the transfer would fail with a message like “Can’t open file”. 


No matter what your FILE NAMES setting, the receiving computer still might have to make 
some changes in the name. For example, MS-DOS restricts a file name to eight characters 
before the dot and three after, so, if necessary, MS-DOS Kermit shortens the incoming 
name. Examples: 


The file sent as : 

OOFA.TXT 
OOFA.TXTXNEW 
OOFA.TXTXX 3 X 
X.LOGIN 

FILEWITHVERYLONGNAME.ANDALONGTYPE 


Is stored in MS-DOS as : 

OOFA.TXT 

OOFA.TXT 

OOFA.TXT 

X. LOG 

FILEWITH.AND 


Thus a file can have up to three names in its passage: its original name, the name it is sent 
with, and the name it is stored under on the receiving system. Hence the three names 
shown in the fullscreen file transfer display: 

Sending: 00FA.TMP;6 => OOFA.TMP => oofa.tmp 


To accomplish effects not possible with set file names, use the “as-name” option of the 
SEND or RECEIVE command, for example: 

C-Kermit>receive oofa.new Oofa.Old 
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Filename Collisions 


What should C-Kermit do if it receives a file that has the same name as an existing file? 
Should it silently overwrite the existing file? Should it make an effort to preserve the ex¬ 
isting file? Should it reject the incoming file? These are called file collision actions, and 
you have six to choose from: 

SET FILE COLLISION BACKUP 

This setting, which is C-Kermit’s default file collision action, allows the file to arrive 
and to be stored under the name it was sent with, without destroying any previously 
existing file that has the same name. The existing file is given a new, unique name 
that fits within the operating system’s file naming restrictions, generally by adding 
digits to the name; for example, in UNIX oof a. txt becomes oof a. txt. ~1~. 

See the appropriate appendix for details. 

SET FILE COLLISION OVERWRITE 

Overwrites (replaces) the existing file. Use this setting with caution. 

SET FILE COLLISION APPEND 

Adds the incoming file to the end of the existing file. This option is useful for append¬ 
ing information to a log file, but it should be used with caution to avoid, for example, 
joining two files of different types (like text and binary). 

SET FILE COLLISION DISCARD 

Refuses and/or discards the incoming file and preserves the existing file. This option 
is handy for resuming multi-file transmissions that were broken. Only those files that 
do not have a counterpart on the receiving system are transferred. 

SET FILE COLLISION RENAME 

This is just like the BACKUP option, except that the incoming file gets the new name, 
rather than the existing file. 

SET FILE COLLISION UPDATE 

Accepts the incoming file only if it is newer than the existing file, in which case the 
existing file is overwritten. This feature depends on the file creation date field in the 
attribute packet (explained in Chapter 8), and requires the other Kermit to support at¬ 
tribute packets (Table 1-1, p. 8). The update option is handy for keeping a parallel 
collection of files up to date on another computer; only those that have changed since 
the last update are sent. 

The SET FILE COLLISION command is effective only when given to the file receiver. The 
VMS and Open VMS versions of C-Kermit always create a new version of any incoming 
file that is not rejected, preserving earlier versions according to the file’s version limit, 
which makes the BACKUP, OVERWRITE, APPEND, and RENAME options identical in VMS 
and Open VMS. 
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Incomplete Transfers 


If a file transfer fails in the middle of a file for any reason—the connection is broken or a 
disk write fails—there is no way to resume it and the data transferred so far is lost. This 
can be frustrating if you are transferring a very long file. But it’s the proper behavior; you 
should not be led to believe that an incomplete file is the result of a successful transfer. 
Nevertheless, C-Kermit gives you the option of keeping incompletely received files. 
However, you must ask for it explicitly: 

SET FILE INCOMPLETE { KEEP, DISCARD } 

This setting tells whether a partially received file is to be kept if the transfer is inter¬ 
rupted for any reason, including intentional cancellation. To keep incomplete files: 
C-Kermit >set file incomplete keep 

The SET file incomplete command is effective only when given to the file receiver ; 
it has no effect when given to the file sender. Synonym: SET INCOMPLETE. 

If you can go back to the system you were sending the file from, break out the part of the 
file that was not sent (using a text editor or other utility), and send the remainder using set 
file COLLISION append on the receiving end, the result should be pretty close to what you 
wanted. 

Keeping a Record of Your File Transfers 

During a long multi-file transfer, you probably have better things to do than keep your 
eyes glued to the screen. But then how will you know what happened? You can ask 
C-Kermit to keep a record for you, called a transaction log: 

LOG TRANSACTIONS [ filespec [ { APPEND, NEW }]] 

Records information about the file transfer, including the date and time, file name, file 
type (text or binary), statistics, and error messages, in the given log file. The default 
log file name is transact . log (lowercase on UNIX) on the current disk and direc¬ 
tory. C-Kermit creates a new log file, overwriting any existing file of the same name, 
unless you include the keyword append after the filename. Examples: 

C-Kermit> loq trans (transact.log, new) 

C-Kermit >log t tuesday.log new (A new daily log) 

C-Kermit> log t february.log append (Add to a monthly log) 

CLOSE TRANSACTIONS 

Closes the current transaction log file, if any. The transaction log is also closed auto¬ 
matically when you EXIT from C-Kermit. 
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Summary 


First-time Kermit users sometimes find the mechanics of file transfer confusing. But it’s 
not very hard if you keep a few basic points in mind. First, establish a connection from 
the Kermit program on your local computer to the remote computer and, if necessary, log 
in on the remote computer. 

Second, start the Kermit program on the remote computer. A Kermit program can’t trans¬ 
fer a file unless it has another Kermit program to transfer it with! Now, just follow these 
three easy steps: 

1. While still connected to the remote computer, tell the remote Kermit what to do: SEND 
or RECEIVE. 

2. Return to your local Kermit program by typing its CONNECT-mode escape sequence, 
such as Ctrl-\C (usually) for C-Kermit or Alt -X for MS-DOS Kermit. Note that 
some communication software programs are always in “CONNECT mode,” and there¬ 
fore do not require you to escape back. 

3. At your local Kermit’s prompt, tell it what to do: receive or send, or select receive 
or SEND from your local software’s file transfer menu. This is the opposite of what 
you told the remote Kermit to do. If you told the remote Kermit to SEND, you should 
tell the local Kermit to RECEIVE, and vice versa. 

When you are finished using the remote computer, remember to CONNECT back to it (if 
necessary) and log out. 

You can transfer groups of files by including wildcard characters in the SEND-command 
file specification, you can record the progress of your file transfers in a transaction log, 
and you can use SET file commands to select text or binary transfers, the treatment of 
filenames, the handling of filename collisions, and the disposition of incomplete transfers. 
Here is a quick summary of the SET FILE commands presented in this chapter: 

SET FILE COLLISION 

Options: APPEND, BACKUP, DISCARD, OVERWRTE, RENAME, UPDATE. Default: 
backup. Function: Specifies action to be taken when a file arrives that has the same 
name as an existing file. Give this command to the file receiver. 

SET FILE DISPLAY 

Options: CRT, fullscreen, serial, or none. Default: SERIAL. Function: Selects for¬ 
mat for file transfer display. For use when C-Kermit is in local mode. 

SET FILE INCOMPLETE 

Options: DISCARD, KEEP. Default: DISCARD. Function: Tells what to do with a file in¬ 
completely received. Give this command to the file receiver. 
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SET FILE NAMES 

Options: CONVERTED, literal. Default: CONVERTED. Function: Specifies how to 
handle file names during transfer. Meaningful to both the file sender and the file 
receiver. 

SET FILE TYPE 

Options: text or binary. Default: text. Function: Selects text or binary mode for 
file transfer. Give this command to the file sender and, if necessary, also to the file 
receiver. 


PROBLEMS: If a file transfer fails, use the SET PARITY command and try again. If it still 
fails, read Chapter 6. If file transfer works but the transferred file has the wrong format, 
issue the appropriate set file type command and try again. If file transfers work but 
seem inefficient, read Chapter 8. 

Use the show file command to display C-Kermif s file type, collision action, file naming, 
incomplete file treatment, transaction log, initialization file name, and other file-related 
settings: 

C-Kermit> sho file 

File parameters: 

Attributes: on 
Names: converted 

Type: text 

Collide: backup 

Display: fullscreen 

Incomplete: discard 
C-Kermit> 


Debugging Log: none 

Packet Log: none 

Session Log: none 

Transaction Log: none 

Init file: .kermrc 


These are the ABCs of Kermit file transfer, suitable for use between any two Kermit 
programs. More advanced and simpler techniques, which you can use once you have mas¬ 
tered the basic techniques, are described in the following chapters. 
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Chapter 6 


Solving File Transfer Problems 


OOOO 

If you had no trouble transferring files using the basic techniques given in Chap¬ 
ter 5, please do not feel compelled to read this chapter. But don’t tear these 
pages out of the book and rip them into tiny shreds; some day you might need 
them. For now, skip ahead to Chapter 7 on page 139, which shows you how to 
turn C-Kermit into a file server and how to use C-Kermit as a client of another 
C-Kermit server—much easier than the SEND/RECEIVE style of operation you 
have been using up till now. Then go on to Chapter 8 to learn how to transfer 
files more efficiently. 

Like people, computers have different languages, conflicting customs, competing 
ideologies, quirks, idiosyncracies, and bad habits. Telecommunications systems punch 
holes in our data. Sensible data on one computer becomes incomprehensible gibberish on 
another. To transfer files in a diverse, and sometimes hostile, computing and communica¬ 
tions environment, Kermit software programs use the Kermit protocol, a set of rules and 
procedures for exchanging structured, error-checked messages with each other. 

Kermit’s default settings for all kinds of communications-, file-, and protocol-related 
items are based on the most common situations. But there are hundreds of different kinds 
of computers in the world with different styles of communication and different file for¬ 
mats, and there are many different ways to connect these computers. You should expect 
to encounter some combinations where the defaults don’t work. 
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Even Parity Bit No Parity 


Figure 6-1 Character Formats 


Because C-Kermit lets you control virtually every aspect of its operation, you can teach it 
to overcome computer-related incompatibilities and communications impediments, and 
you can help it achieve maximum efficiency under all sorts of conditions. Let’s look at 
the effects of the communications environment on file transfer and how you can use the 
set command to adapt C-Kermit to them. 

Parity 

The most common cause for file transfer failure is parity. Let’s say that once again, with 
emphasis: 

The most common cause for file transfer failure is parity. 

Computers store characters in 8-bit “bytes.” Some computers prefer to transmit these 
bytes as 7 bits of data plus one bit of error-checking information, called the parity bit. The 
parity bit replaces one of the data bits. 19 The parity bit is set to 0 or 1 based on the values 
of the remaining seven data bits. There are five kinds of parity: even, odd, mark, space, 
and none. Even parity sets the parity bit to make the overall number of 1-bits in the trans¬ 
mitted character even. Odd parity makes the overall number of 1-bits odd. Mark parity 
always sets the parity bit to 1, and space parity always sets it to 0. 

Parity is an unpleasant fact of life in data communications. The receiver of a transmitted 
character can’t tell from looking at it whether it has 7 data bits and 1 parity bit, or 8 data 
bits. (See Figure 6-1.) Can you? Parity prevents the transmission of 8-bit data bytes, 
such as we find in binary data or international character codes. 

During terminal emulation, C-Kermit ignores parity unless you tell it otherwise, on the as¬ 
sumption that only 7-bit ASCII or ISO 646 characters are being transmitted and the 8th bit 
carries no useful information. That is, C-Kermit assumes parity is probably in effect with¬ 
out the user’s knowledge. 


19 Other arrangements are possible but occur rarely in practice. In the most common case, and the one 
supported by Kermit, a byte is always transmitted as 8 bits: either 8 data bits and no parity bit, or 7 data 
bits and a parity bit. 
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During file transfer, C-Kermit normally puts the communication line into 8-bit no-parity 
mode so it can transmit 8-bit data, on the assumption that the other Kermit program can do 
this too. Most Kermit programs can. The major exception is IBM mainframe Kermit, due 
to limitations of the IBM mainframe communication architecture. 

However, it can—and often does—happen that a network or communication device be¬ 
tween C-Kermit and the other computer might be using parity, even when both computers 
are not. 


File transfers can fail when parity is in use but the Kermit programs do not know about it, 
because Kermit might misinterpret the parity bits as data bits. Luckily, this situation is 
caught by Kermit’s own error-checking procedure so parity will not cause files to be trans¬ 
ferred incorrectly—it simply prevents them from being transferred at all. Usually the er¬ 
ror message is something like “Failure to receive acknowledgement” or “Too many 
retries.” If this happens to you, use the set parity command to tell the Kermit program 
what the parity is: 

SET PARITY { EVEN, ODD, MARK, SPACE, NONE } 

This command, when given with any of its options other than NONE, tells Kermit to 
actually add the selected type of parity bit to all characters it sends, during both 
CONNECT mode and file transfer, and to remove the 8th bit of incoming characters. 


If you don’t know which kind of parity to use, don’t worry. Just pick one. even is a good 
first choice for serial connections; try SPACE for TCP/IP telnet or rlogin connections. 
Give matching SET PARITY commands to the two Kermit programs and file transfer should 
work smoothly: 

C-Kermit> receive (Receive a file) 

Alt-x (Escape back) 

MS-Kermit> set file type binary (Binary transfer mode) 

MS-Kermit> send budget.wks (Send a spreadsheet file) 

(Many retries, and then...) 

?Unable to receive acknowledgement from host 


MS-Kermit>connect 
C-Kermit> set parity even 
C-Kermit> receive 
Alt-x 

MS-Kermit> set parity even 
MS-Kermit> send budget.wks 

(The file is transferred) 

Transfer complete. 
MS-Kermit> 


(Let's try it again) 
(Once more, with parity) 

(Escape back again) 

(Here too) 

(Send it again) 


(This time it works) 


If EVEN or SPACE parity doesn’t do the trick, try MARK or ODD. MARK is used with some 
mainframes and X.25 networks. ODD is rarely, if ever, used in data communications. 
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When PARITY is used during file transfer, data characters whose 8th bit is 1 are transmitted 
as 2-character sequences: the data character itself has its 8th bit replaced by a parity bit, 
and the result is preceded by an ampersand (&) character, which also has the appropriate 
parity bit applied to it. The receiving Kermit removes the 8th bit from each arriving 
character and converts the special 2-character sequences back to a single 8-bit character. 
As you can imagine, this can add a lot of transmission overhead. But it does allow Kermit 
to transfer 8-bit data through a 7-bit connection, a claim that other protocols cannot make. 

HINT: Some Kermit programs, including C-Kermit and MS-DOS Kermit, attempt to 
detect parity automatically during packet operations, so even if you forget to SET parity 
there is a chance the transfer will work correctly anyway. This technique is not totally de¬ 
pendable because there is no way to tell the difference between space parity and no parity 
at all. So it is still better to set parity explicitly, on both ends of the transfer, if your 
connection does not allow 8-bit data to pass through. But in case you had your parity set 
to none and found it changed to, say, even after a file transfer, now you know why. 

Speed and Flow Control in the Full Duplex Environment 

During file transfer, Kermit programs compose a packet and send it as a unit, all at once. 
But the receiving computer might not be able to swallow that many bytes in one gulp, in 
which case the file transfer could fail. Like when your sink backs up—the water doesn’t 
go down the drain as fast as it comes out of the faucet and eventually it spills onto the 
floor. With computers, this condition is called a buffer overflow. 

Buffer overflows rarely occur on network connections, but are common on serial (direct or 
dialed) connections. One way to cope with buffer overflows is to connect the two com¬ 
puters at a lower transmission speed. The slower the data bytes arrive, the more time the 
computer has to process them. However, reducing transmission speed increases the time 
it takes to transfer a file, and therefore also your phone bill and your aggravation level. 

If your serial transmission speed is too high, buffer overflows can result in lost characters 
and therefore packet retransmissions and reduced efficiency. If the speed is too low, 
transmission capacity is wasted. But there is no way to pick the perfect speed—speeds, 
like clothes, only come in certain sizes: 1200, 2400, 4800, ... (those are speeds, not 
waist sizes). And conditions change: computers can slow down and speed up depending 
on what other tasks they are working on. 

If you have a full duplex connection between your computers, you may be in luck. While 
one computer is sending a packet, the other computer can talk back to it: “Stop!” “OK, 
I’m caught up, continue.” This is called flow control. It works if both computers know 
how to do it and are told in advance that they should do it. There are two major types of 
flow control: 
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Computer B 



Software flow control 

is accomplished by inserting special characters into the data stream. These characters 
are normally Ctrl-S (XOFF), and Ctrl-Q (XON). The data receiver sends an XOFF to 
tell the sender to stop sending, and an XON to tell it to resume sending. 

Hardware flow control 

occurs between the computer and the device it is immediately connected to, for ex¬ 
ample, a terminal server or a high-speed modem. It is accomplished using special 
wires, normally the RS-232 Request To Send (RTS) and Clear To Send (CTS) circuits. 
When both devices are properly configured for the same type of hardware flow con¬ 
trol, its effect is immediate. 

To illustrate, Figure 6-2 shows a modem connection between two computers. Computer 
A is connected to its modem at 19200 bps, but the two modems are connected at only 
1200 bps. Modem A takes care of the speed discrepancy with its speed matching feature. 
But now Computer A can send data into Modem A much faster than Modem A can send it 
to Modem B. So Modem A stems the flow of data from Computer A by turning off its 
CTS signal, and then turns it back on when it is ready for more data. This type of flow 
control is often used by error-correcting modems; if the telephone connection is noisy, the 
modems might be retransmitting data between themselves, and therefore must block fur¬ 
ther data arriving from the computer. 

Now let’s turn the tables. Suppose Computer A isn’t fast enough to keep up with the data 
coming in from Modem A. Computer A turns off its RTS signal to make the modem stop 
sending. But Computer B doesn’t know about this, so it continues to send data. Some¬ 
how Modem A has to tell Modem B to stop sending, then Modem B has to tell Computer 
B. For all this to work, there must be some kind of higher-level protocol going on between 
the two modems (such as MNP or V.42), and local flow control of some kind must be en¬ 
abled between Modem B and Computer B. Thus, for hardware flow control to function ef- 
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fectively, it must take place on all segments of the connection and it should propagate 
rapidly from one end to the other. 

When flow control is in effect and working properly, you can set the transmission speed to 
the highest value offered by the physical connection and you shouldn’t have to worry 
about buffer overflows. Assuming the flow control signals are delivered promptly and 
correctly, the effective data rate will be as high as it could possibly be at any given mo¬ 
ment, adjusting itself automatically to varying conditions of load on the two computers 
and the communication medium. 

The command governing flow control is: 

SET FLOW-CONTROL { DTR/CD, DTR/CTS, KEEP, NONE, RTS/CTS, 
XON/XOFF } 

Selects the desired type of flow control: Xon/Xoff (software), DTR/CD, DTR/CTS, or 
RTS/CTS (hardware), no change (KEEP), or none at all (NONE). Xon/Xoff flow con¬ 
trol is used during file transfer when the underlying operating system supports it, un¬ 
less you tell Kermit otherwise. Hardware flow control options are available only in 
Kermit implementations where the underlying operating system supports them, and 
they are effective only for serial communication devices. Type a question mark after 
SET FLOW to see which options are offered by your version of C-Kermit: 

C-Kermit >set flow ? One of the following: 
none keep rts/cts xon/xoff 

Software flow control generally operates end to end; that is, between C-Kermit and the 
computer on the other end of the connection. The Xon and Xoff characters are subject to 
delay and corruption, just like any other transmitted characters. If you have a long-delay 
connection, for example one where it takes a second or two for your characters to echo, 
software flow control probably will not be very effective. 

Hardware flow control solves these problems and should be used when available. Even 
when C-Kermit’s SET FLOW-CONTROL command does not offer RTS/CTS or other 
hardware flow control methods, it still might be possible for you to use hardware flow 
control on your connection by issuing an operating system command before you start 
C-Kermit, or by using a special device name in the SET line command, in conjunction 
with C-Kermit’s set flow-control keep option. See the appendix for your operating 
system (Appendix III for UNIX, IV for VMS and Open VMS, and so on). 

On most network connections, particularly TCP/IP, it might be beneficial to SET FLOW 
NONE. The network takes care of flow control itself, so Kermit (or the underlying operat¬ 
ing system’s terminal device driver) doesn’t need to duplicate the effort, and this can 
make your file transfers go faster. 
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Half Duplex Communication 

Half duplex communication should be familiar to anyone who has used CB radio, but may 
seem unnatural to the rest of us who are accustomed to immediately blurting out any 
thoughts that come into our heads. It works just like CB: while you are talking, the other 
person can’t talk until you release your talk button. When the direction of transmission is 
reversed, you have to wait until the other person is finished. If you talk out of turn, your 
partner won’t hear you. 

The talk button is the key to this process. When computers are connected with a half 
duplex communication channel, they too have a talk button. It is usually a special control 
character. A computer can send a message of any length at all, and the communication 
line cannot turn around until this character, called a handshake, is sent. 

Certain kinds of mainframes communicate with their terminals in half duplex. The person 
at the terminal types a command and terminates it with the Enter key (which sends a car¬ 
riage return character). The carriage return turns the communication channel over to the 
mainframe. The mainframe responds to the command, possibly sending many lines or 
screens full of who knows what, and when it is done sends its own handshake character, 
such as an XON (Control-Q) character. The carriage return is the terminal’s handshake, 
and the XON is the mainframe’s. 

Kermit’s commands for half duplex communication are: 

SET DUPLEX HALF 

Enables local echoing during terminal connection. This command does not affect file 
transfer, but is listed here for completeness. Synonyms: SET LOCAL-ECHO ON, 
SET TERMINAL ECHO ON. 

SET FLOW-CONTROL NONE 

Disables full-duplex flow control. Xon or Xoff characters sent out of turn by 
C-Kermit to a half-duplex computer could interfere with successful communication. 
However, it might still be possible to use hardware flow control, such as RTS/CTS, for 
example, if you are using a high-speed modem that supports it. 

SET HANDSHAKE [ { BELL, CR, ESC, LF, NONE, XOFF, XON, CODE number } ] 
During file transfer, C-Kermit should wait for the specified character after a packet 
has been received before sending the next packet, so as not to send the packet before 
the other Kermit program is prepared to read it. C-Kermit’s default handshake is 
NONE. The most common handshake character on half duplex connections is XON. 

If you have made a connection to a remote computer and found that you had to set 
duplex half before you could see your characters echo during connect mode, and then 
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you found that file transfer didn’t work and that SETting parity was not enough to cure 
the problem, try set handshake xon or one of the other handshake options. For ex¬ 
ample, the following settings are typical for a linemode connection to an IBM mainframe: 


C-Kermit> set parity mark 
C-Kermit> set duplex half 
C-Kermit> set flow none 
C-Kermit>set handshake xon 


(Parity is mark) 

(Local echo is needed) 

(No full-duplex flow control) 
(Handshake is xon) 


How do you know what the handshake character is? One way to find out is to use 
C-Kermit’s session-debugging feature, which displays control characters on your screen in 
printable form during connect mode. Here is an example in which we give a command 
to an IBM mainframe and then observe the last character it sends after executing the com¬ 
mand. This is most likely the handshake character: 

C-Kermit> set debug session 
C-Kermit>connect 

■ query time "J A M"@TIME IS 15:28:00 EST MONDAY ll/23/92"M , 'J"@ 

Ready; T=0.01/0.01 15:28:01 A M*J A @. A Q 

The final character is “~Q” —Control-Q (XON), and that’s your handshake character: set 
HANDSHAKE XON. 


Noise and Interference 


Once you have found a common “language” for the two computers, you still have no 
guarantee that they can communicate, any more than the fact that two people speak the 
same language guarantees they can talk at a party with loud music and other people shout¬ 
ing in their ears. If I ask you “Are you having fun?” and you respond “Tomatoes and 
lemons,” I know you didn’t receive my message correctly and I repeat my question. 

Data signals are subject to distortion, interference, and loss as they travel through the 
wires. One of Kermit’s most important jobs is to detect when this happens and retransmit 
any portions of your data that were damaged. Kermit does this by including a block check 
in each Kermit packet. The packet sender computes the block check when constructing 
the packet, and the packet receiver computes its own version when reading the packet. If 
the two don’t agree, the packet is rejected by the receiver and retransmitted. 

Block Check Options 

Unless you say otherwise, Kermit includes only one block check character per packet. Al¬ 
though this is sufficient for most occasions, there is always a probability that certain kinds 
of damage can occur that won’t be detected by this method. This probability increases 
with the packet length, and is also higher for 8-bit data than for 7-bit data. Therefore, Ker¬ 
mit offers a selection of block checks: 
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SET BLOCK-CHECK 1 

A single-character block check, the 8-bit sum of all the other characters in the packet, 
folded into 6 bits. This is the default. 

SET BLOCK-CHECK 2 

A two-character block check, the 12-bit sum of all the other characters in the packet. 

SET BLOCK-CHECK BLANK-FREE-2 

A two-character block check, the 12-bit sum of all the other characters in the packet, 
exactly like type 2, except encoded in such a way that neither of the two characters can 
be a blank. For use on connections where “trailing blanks” might be stripped. 

SET BLOCK-CHECK 3 

A three-character block check, the 16-bit cyclic redundancy check (CRC) [47] of all 
the other characters in the packet. 

The higher the block check number, the stronger the error detection, but (there’s a price 
for everything) file transfer is slightly less efficient. Block check types 2, B, or 3 are 
recommended when using long packets, transferring 8-bit data, or when the connection is 
particularly noisy. 

The single-character block check is supported by all Kermit programs. It is sufficient for 
relatively clean serial connections and connections provided by error-correcting modems 
or networks. The two- and three-character block checks are optional features of the Ker¬ 
mit protocol (but supported by most Kermit programs—see Table 1-1, p. 8); if the other 
Kermit doesn’t support them, the single-character block check is used automatically, even 
if you ask for a higher one. 

The Retry Limit 

Damaged packets are recovered by automatic retransmission. But there is a limit to the 
number of times each packet can be retransmitted. If the limit is exceeded, Kermit con¬ 
cludes that the connection is unusable and gives up with an error message like “Too many 
retries” or “Unable to receive acknowledgement”. C-Kermit allows 10 retries per packet. 
You can use the set retry command to change this number: 

SET RETRY number 

Specifies the maximum number of retransmissions allowed for each packet. Example: 
C-Kermit> set retry 20 

The purpose of the SET retry command is to help Kermit decide when a connection is 
unusable. Increase the retry limit if you know that the connection is very noisy and you 
want Kermit to make every effort to push the file through, even if the cost in retransmis¬ 
sions (and the size of your phone bill) is high. Reduce the number if you want Kermit to 
detect and give up on a bad connection quickly. 
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Timeouts 


C-Kermit expects to receive each packet within a reasonable amount of time, the timeout 
interval. At the beginning of a file transfer, each Kermit program tells the other the 
timeout interval to use. Thus C-Kermit’s timeout interval is normally determined by the 
other Kermit. The timeout interval that C-Kermit tells the other Kermit to use depends on 
the type of connection. 


When you make a SET HOST or telnet network connection, C-Kermit has no way to 
know the connection speed, and so it uses a built-in default timeout value of 10 seconds. 


On a serial connection, C-Kermit calculates a timeout interval based on the communica¬ 
tion speed and packet length. For example, if the speed is 1200 bps (=120 characters per 
second) 20 and the packet length is 6000, it would take: 


6000 chars 
120 chars! sec 


50 seconds 


to transmit a packet. C-Kermit adds 10 percent for safety, raising the interval to 55 
seconds. 


But some connections might be slower than C-Kermit expects. For example, a 9600 bps 
serial connection might be routed through a congested wide-area network, where each 
packet must queue up at a succession of overloaded packet-switch nodes and wait its turn 
to be relayed to the next node until it reaches its final destination, resulting in a transfer 
rate far slower than 9600 bps. 

When a packet doesn’t arrive in time, an alarm goes off. The file sender retransmits its 
previous packet or the file receiver sends a request for the expected packet that did not ar¬ 
rive. But if the tardy packet was already on the way, it will arrive eventually, followed by 
a second, redundant copy of itself resulting from the timeout. The process can repeat 
throughout the transfer, slowing the pace to a crawl or even causing the transfer to fail. 
The solution is to adjust the timeout interval: 

SET { SEND, RECEIVE } TIMEOUT number 

This command tells C-Kermit to set the timeout interval to the given number of 
seconds, rather than calculating it automatically. SET RECEIVE TIMEOUT tells C-Kermit 
to tell the other Kermit what timeout interval to use, bypassing C-Kermit’s timeout 
calculation. SET SEND TIMEOUT tells C-Kermit to use the given timeout, regardless of 
what the other Kermit requests. 


20 In asynchronous serial transmission, there are 10 bits per character because of the stop bit and start bit. 
See Appendix II. 
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UNIX 



Here is a real-life example, in which scientific and survival data is sent from an Antarctic 
outpost to a relay station in Florida via an aging earth satellite, which can cut out for 
periods as long as a minute and a half, transmitting through such exotic sources of noise 
interference as aurora borealis [20]: 


C-Kermit> set send timeout 120 
C-Kermit> set rec time 120 
C-Kermit> set retry 100 
C-Kermit> set block 3 
C-Kermit>send ozone.dat 


(A 2-minute timeout) 

(In both directions) 

(Allow many retries) 

(Use strongest error checking) 
(Send ozone-layer data) 


Premature timeouts can also occur if C-Kermit does not know what your true communica¬ 
tion speed is. A common scenario is shown in Figure 6-3, in which you are dialed at 1200 
bps to a terminal server that hides your true connection speed from C-Kermit. You can 
inform the operating system of your true speed before starting C-Kermit, as explained in 
Chapter 5, or you can tell C-Kermit to use a longer timeout based on the packet length you 
are using and your true communication speed, for example: 

C-Kermit> set receive timeout 10 (For 1000-byte packets) 

10 seconds should allow enough time for a 1000-character packet to be transmitted at 120 
characters per second. 


To override the timeouts calculated by both Kermit programs, you can either (a) give each 
Kermit a set receive TIMEOUT command, or (b) give both a SET receive timeout and a 
SET SEND TIMEOUT to one of them. 
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Transparency Problems 


Kermit packets are normally framed by a Control-A character (Start of Header) at the 
beginning and Carriage Return (Control-M) at the end. In between, there are no control 
characters at all. Control characters in your file data are encoded as printable character se¬ 
quences (for example, Control-S is encoded as #s) to prevent their interception by devices 
or drivers along the communication pathway (which is why Xon/Xoff flow control can 
work during file transfer). 


But some computers or communication processors won’t let even these two innocent con¬ 
trol characters pass by unscathed. For example, we have heard of at least one modem that 
uses Control-A as its escape character: send your first Kermit packet and you’re back talk¬ 
ing to your modem dialer instead of to the other computer! For pathological cases like 
this, C-Kermit lets you adjust the framing of the packets: 

SET { SEND, RECEIVE } START-OF-PACKET number 

Changes the packet-start character from Control-A to something else, which can be 
any 7-bit ASCII character. A control character should be used unless the communica¬ 
tion path refuses to allow any control characters at all to pass through. Give the ASCII 
code for the character (see Table VIII-1, page 461); for example, 2 for Ctrl-B, 5 for 
Ctrl-E. You must give corresponding commands to both Kermit programs: 

MS-Kermit> set send start-of-packet 7 (PC sends Ctrl-G) 
MS-Kermit >connect (Connect to remote) 

C-Kermit> set receive start 7 (C-Kermit receives Ctrl-G) 

C-Kermit >send oofa.txt (Start the transfer) 

Alt-x (Escape back to the PC) 

MS-Kermit> receive (Receive the file) 

Here we change the packet-start character only for the packets that are being sent by 
the PC to C-Kermit; Control-A is still used to start the packets send by C-Kermit to 
the PC. You can also change the packet-start character in the other direction, or in 
both directions. Just remember to give the corresponding SET SEND START-OF-PACKET 
and set receive start-of-packet commands to both Kermit programs. 


SET { SEND, RECEIVE } END-OF-PACKET number 

Changes the packet-end character from Carriage Return to something else, which must 
be an ASCII 7-bit control character. Give corresponding commands to both Kermits, 
for example: 


MS-Kermit> set send end-of-packet 
MS-Kermit >connect 
C-Kermit> set receive end 10 
C-Kermit>receive 
Alt-x 

MS-Kermit>send *.txt 


10 (PC sends Ctrl-J) 

(Connect to remote) 
(C-Kermit receives Ctrl-J) 
(Wait for files) 

(Escape back to the PC) 
(Send some files) 


This changes the packet terminator in the PC-to-C-Kermit direction. 
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In addition to changing the packet start and end characters, you can also tell C-Kermit to 
send additional characters between the packets: 

SET { SEND, RECEIVE } PAD-CHARACTER number 

Specifies an additional character to insert before the start-of-packet character. It must 
be different from the start-of-packet character. Pad characters are ignored by the Ker- 
mit protocol, but can be useful to give the receiving computer time to prepare to read 
the packet. There is at least one case where the pad character is used to put the packet 
receiver’s front end into a special “transparency mode.” Without this the packet itself 
could not pass through, set send pad-character tells C-Kermit which character to 
send for padding; set receive pad-character tells C-Kermit to tell the other 
computer’s Kermit program which character to send as padding. 

SET { SEND, RECEIVE } PADDING number 

This tells how many copies of the pad character to insert before each packet. 


Here, for example, is the series of commands that allows C-Kermit to transfer files with a 
Cray supercomputer running the CTSS operating system and Cray Kermit: 


C-Kermit >set parity even 
C-Kermit >set send end 23 
C-Kermit >set send padding 1 
C-Kermit >set send pad-char 26 
C-Kermit>send animation.txt 


(Even parity required) 
(Packet end is Ctrl-W) 
(Use 1 pad character) 
(Pad char is Ctrl-Z) 
(Now send a file) 


IBM Mainframe Linemode Communication 


There are two types of connections to IBM mainframes: full screen and linemode. A 
full-screen connection goes through a device that converts between IBM 3270 EBCDIC 
block-mode terminal and asynchronous ASCII character-mode terminal conventions. For 
brevity, we call this device a 3270 protocol converter. It masks all the peculiarities of 
IBM mainframe-style communication from the user and can be used (usually) with little 
extra effort. 

IBM mainframe linemode connections, on the other hand, require Kermit to jump through 
more than a few hoops. Nearly every communication parameter—duplex, parity, flow 
control, handshake—is contrary to C-Kermit’s defaults, and so must be set explicitly. 

The next page shows an example of a C-Kermit local-mode file transfer with an IBM 
mainframe running the VM/CMS operating system. To add a little spice, the modem in¬ 
tercepts the Ctrl-A character, so Kermit’s packet-start character must be changed (the 
modem name below is fictional, to avoid lawsuits). 
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To complicate matters further, the login process reveals the connection to be very noisy, 
so the user prudently adjusts communication parameters for extra noise resistance. 


$ kermit 

C-Kermit 5A(188) 23 Nov 92 


Type ? or HELP for help 
C-Kermit> set modem xyz 
C-Kermit> set line /dev/ttyh8 
C-Kermit> set speed 2400 
C-Kermit> set parity mark 
C-Kermit> set duplex half 
C-Kermit >set flow none 
C-Kermit >set handshake xon 
C-Kermit >set send start 2 
C-Kermit> dial 5551234 
Connection completed. 
C-Kermit> connect 
VIRTUAL MAC~xINE/S{{TEM PRODU=T 
. login olga 

Enter password; XXXXXXXX 


(Start Kermit on UNIX) 

SunOS 4.1 

(Specify modem type) 

(and communication device) 

(and speed) 

(Mainframe needs mark parity) 
(Connection is half duplex) 

(No full duplex flow control) 
(Use XON for line turnaround) 
(Change out-packet start to *B) 
(Dial the number) 

(The call is answered) 

(Connect to the mainframe) 
(Notice the noisy herald) 

(Log in) 


LOGON AT 22:00:52 EDT SU—{Y 08/11/92 
VM/SP REL 5 04/19/88 19:39 


Ready; T=0.07/0.11 2—{{:55 
CMS 


. kermit (Run Kermit on the mainframe) 

Kermit-CMS Versi%x 4.2.4 

Enter ? for a —st of valid commands 


Kermit-CMS> set retry 20 (Allow many retries) 

Kermit-CMS> set block 3 (Use strongest error checking) 

Kermit-CMS >set receive start 2 (Change in-packet start to ''B) 
Kermit-CMS >send profile exec (Send a file) 

Kermit-CMS ready to send. 

Please escape to local Kermit now to RECEIVE the file(s). 


KERMIT READY TO SEND... 

Ctrl-\c 

C-Kermit> set retry 20 
C-Kermit>receive 
SF 

PROFILE.EXEC A Size: 18113 
=> profile.exec ..N%N%..T%..N%. 
B 

C-Kermit> connect 

Kermit-CMS> exit 
Ready; T=0.02/0.08 22:01:37 
. logoff 
Ctrl-\c 
C-Kermit>exit 
$ 


(Escape back to C-Kermit) 

(Allow many retries) 

(Tell it to receive the file) 

• T%T%T%N%.T% . .N% . . Z [OK] 

(Connect back to the mainframe) 
(Leave mainframe Kermit) 

(Log out) 

(Escape back to C-Kermit) 

(Exit from C-Kermit) 
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IBM Mainframe Full-Screen Communication 


Full-screen Kermit connections to IBM mainframes go through 3270 protocol converters. 
These devices translate between normal ASCII and the IBM EBCDIC character sets, they 
translate IBM 3270 screen directives into escape sequences for your terminal, and they 
generally fool the parties on either end of the connection into thinking they are dealing 
with their own familiar world. 

The techniques used by C-Kermit to transfer files with an IBM mainframe through a 
protocol converter depends on whether the protocol converter can be put into transparent 
mode by IBM mainframe Kermit. Transparent means the protocol conversion functions 
are turned off, and the device passes data through without modification. Some protocol 
converters, such as the IBM 7171, allow this. Others, such as the IBM 3708 or certain ter¬ 
minal servers with built-in 3270 emulation, do not. 

A connection to a protocol converter is just like a connection to a full-duplex computer 
host or service, except that even parity is usually a requirement. 

File Transfer with Transparent Mode 

Most 3270 protocol converters allow transparent mode operation, which is preferred be¬ 
cause it makes for simpler and more efficient file transfer. Common examples include the 
IBM Series/1, 7171, 4994, 3174 AEA, and 938x ASCII subsystem, as well as many non- 
IBM products. Kermit-370 on the IBM mainframe attempts to detect transparent-mode 
capability automatically and use it. When automatic detection doesn’t work, IBM main¬ 
frame Kermit’s SET CONTROLLER command can be used to force a specific style of trans¬ 
parency when it is available. 

When the protocol converter can be put into transparent mode, file transfer works nor¬ 
mally: 

C-Kermit >set parity even 
C-Kermit >show communications 
Line: ttx4, speed 19200, parity: even 
duplex: full, flow: xon/xoff, handshake: none, ... 

C-Kermit >connect (Connect to the mainframe) 


. kermit (Start mainframe Kermit) 

Kermit-CMS Version 4.2.4 

Enter ? for a list of valid commands 

Kermit-CMS> send maketape exec (Send a file) 

Please escape to local Kermit now to RECEIVE the file(s). 

KERMIT READY TO SEND... 

Ctrl-\c (Escape back) 

C-Kermit> receive (Receive the file) 
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If this example does not work for you, use IBM mainframe Kermit’s SHOW CONTROLLER 
command to find out what kind of transparency, if any, is being used, and then try using 
different set controller commands to achieve transparency: 

Kermit-CMS> set controller seriesl 
Kermit-CMS> set controller graphics 
Kermit-CMS> set controller aea 

and then try the file transfer again. If none of these works, consult the IBM mainframe 
Kermit documentation for further information or ask the IBM mainframe system ad¬ 
ministrators for help. If all else fails, you can access the mainframe in linemode (if that is 
possible at your site) rather than full-screen mode when you need to transfer files, or else 
you can use the non-transparent technique. 

File Transfer without Transparent Mode 

When the protocol converter can not be put into transparent mode, it is impossible to send 
a normal Kermit packet through it because all control characters are filtered out, including 
Kermit’s packet-start and -end characters. Lines (packets) longer than the screen width 
are broken and wrapped, blanks might be discarded, the protocol converter can engage in 
screen optimizations that interfere with packets sent by the mainframe, and each packet 
sent to the mainframe can be echoed once, twice, or more by the protocol converter. 

By switching to a slightly modified version of the Kermit protocol, in which there are no 
distinguished characters to mark the beginning and end of a packet, and with a special 
type of block check that never includes blanks, even these obstacles can be overcome. 
IBM mainframe Kermit version 4.2.3 or later is required. 


The trick is to tell IBM mainframe Kermit to operate in fullscreen mode, rather than trans¬ 
parent mode, then set the packet-start character to be a printable ASCII character, avoid 
the use of handshake characters, and use the “blank-free-2” block check: 


C-Kermit> set parity even 
C-Kermit >set send start 58 
C-Kermit> set receive start 58 
C-Kermit> set block-check b 
C-Kermit> set handshake none 
C-Kermit>connect 


(Even parity) 

(Packet start is 
(in both directions) 

(Type B block check) 

(No handshake) 

(Now go to the mainframe) 


• kermit (Start mainframe Kermit) 

Kermit-CMS Version 4.2.3 

Enter ? for a list of valid commands 

Kermit-CMS>set controller fullscreen (No transparent mode) 


Kermit-CMS>set 

send start 58 

(Packet 

start is ":") 

Kermit-CMS>set 

receive start 

58 (in both 

i directions) 

Kermit-CMS>set 

block-check b 

(Type B 

block check) 

Kermit-CMS>set 

handshake 0 

(Do not 

send handshake) 

Kermit-CMS>send data sas b 

(Send a 

file ...) 


NOTE: All four start-of-packet characters must be the same. 
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The file is transferred more slowly than with transparent mode, but at least it can be done. 
Short packets are used automatically to avoid “formatting assistance” by the protocol 
converter, and various other trickery goes on behind the scenes. In some cases, main¬ 
frame Kermit’s ASCII/EBCDIC translation tables might need to be altered, depending on 
the make, model, and configuration of the protocol converter. For detailed information 
about which protocol converters are transparent and which are not, and about file transfer 
through non-transparent 3270 protocol converters, consult the IBM mainframe Kermit 
documentation [15]. 

For X.25 Users Only 

If you have connected to the remote computer through an X.25 network PAD, your con¬ 
nection is probably set up for character-mode interactive operation. In the normal setup, 
each character you type is sent to the remote computer in a separate X.25 packet so it can 
be processed and echoed immediately. You want this to happen when you are conducting 
an interactive session with the remote computer. However, this mode of operation can be 
very inefficient during Kermit file transfer. Transfers can proceed much faster if you 
change your network connection to make Kermit packets correspond as much as possible 
with X.25 packets. A detailed discussion of X.25 networking is beyond the scope of this 
book, 21 but you might try escaping back to the PAD (normally by typing Ctrl-P) and is¬ 
suing X.3 commands to put the PAD into a mode suitable for Kermit packet transmission: 

Kermit-ll> send report.txt (Send file from remote Kermit) 

Ctrl-P (Escape back to the PAD) 

8 PAR? (See your current PAD settings) 

PARI:1,2:1,3:0,4:80,5:0,6:1,7:0,8:0,9:0,10:80,11:3,12:0 
8 SET 2:0,3:2,4:0,5:1,6:0,10:0,12:1 (Change them) 

^ continue (Connect back to remote host) 

Ctrl -\c (Escape back to C-Kermit) 

C-Kermit> receive (Receive the file) 

These commands tell the PAD not to echo, to forward characters sent by the terminal (that 
is, your local Kermit program) only after a carriage return (Kermit’s normal packet ter¬ 
mination character) has been received, to use no packet forwarding timeout, to enable 
Xon/Xoff flow control between the terminal and the PAD (rather than end-to-end), to sup¬ 
press network messages that might interfere with the Kermit packets, and to do no line 
folding. If your local Kermit has built-in X.25 network support, you can use the cor¬ 
responding SET PAD Kermit commands instead. 

When you connect back after the file transfer, your PAD connection will no longer be 
suitable for interactive use, so you must restore the original PAD parameters, as in the fol¬ 
lowing example: 


21 Read the literature provided by your X.25 service provider, for example, How to Use SprintNet 
Asynchronous Dial Service , or consult references [10, 11,12, 13]. 
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C-Kermit> connect (Connect back to remote) 

Ctrl-P (Escape back to the PAD) 

g SET 2:1,3:2,4:80,5:0,6:1/10:80,12:0 (Restore old settings) 
g continue (Connect back to remote host) 

Kermit-ll> 

Or if you have an X.25-capable version of C-Kermit, use its built-in set pad commands. 
Hint: After you read the chapters on macros and scripts, you will be able to write macro 
commands that make this procedure a lot easier and faster. Another Hint: Certain net¬ 
works have built-in commands to condition your connection for file transfer, for example 
SprintNet’s DTAPE command. See the literature from your network service provider. 


Collecting the Evidence 


If you have file transfer problems, check your protocol-related settings with the SHOW 


PROTOCOL command: 

C-Kermit>show proto 
Protocol Parameters: 
Timeout (used= 8): 
Padding: 

Send 

10 

0 

Receive 

7 

0 

Block Check: 

2 

Pad Character: 

0 

0 

Delay: 

1 

Packet Start: 

1 

1 

Max Retries: 

10 

Packet End: 

C-Kermit> 

13 

13 




Make any desired adjustments and try again. The timeout values are the current SEND and 
receive TIMEOUT settings; the “used=” value is the (possibly adjusted) interval that 
C-Kermit actually used in the most recent transfer. An asterisk (*) next to the SEND 
timeout means you have given a SET SEND TIMEOUT command. 

If all else fails, you can capture C-Kermit’s (mis)behavior in two types of log files: 

LOG PACKETS [ filespec= PACKET.LOG [ { APPEND, NEW ;=NEW ] ] 

Records Kermit’s file transfer packets in the specified file. Use this option to track 
down problems. Show the packet log to a Kermit guru or decode the packets yourself 
if you have a copy of Kermit, A File Transfer Protocol [18], which spells out the 
details of Kermit packet format and protocol rules. 

LOG DEBUG [ filespec= DEBUG.LOG [ { APPEND, NEW J=NEW ] ] 

Records voluminous information about C-Kermit’s inner workings in the specified 
file. For Kermit gurus only. Used for serious late-night marathon debugging sessions 
in combination with the C-Kermit source code. Knowledge of the C programming 
language [46] is a plus. 

These log files are closed automatically when you EXIT from C-Kermit. You can also 
close them at any desired time with the CLOSE PACKETS or CLOSE DEBUG commands. 
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Chapter 7 


Using a Kermit Server 


By now you should be a wiz at Kermit file transfer. You can use SET commands to adapt 
Kermit programs to all sorts of different conditions and you can send files back and forth 
successfully. In this chapter, you’ll learn an easier way to transfer files, in which you 
won’t have to give commands to both Kermit programs. And you’ll see that Kermit not 
only transfers files, but can help you manage them too. 

In Kermit’s basic mode of operation, you tell the remote Kermit what to do, then escape 
back to the local Kermit and tell the local Kermit what to do. If you are only transferring 
one file or one group of files, this is not a major inconvenience—no more than, say, cook¬ 
ing a simple dinner for yourself at home. But if you want to upload some files, download 
some others, delete some, print some, and so on, repeated connecting and escaping back 
can become tiresome. This is more like hosting a dinner party. For such occasions, you 
might prefer to take your friends to a restaurant and eat out. 

A Kermit server is a Kermit program running in a special way. You tell your local Kermit 
program what you want and it tells the Kermit server what to do, like your waiter gives 
your order to the chef. The server performs the required tasks silently, out of sight in the 
kitchen, and relays the results back to your local Kermit program, just as your waiter 
brings your dinner once the chef has prepared it. 

The difference between using a Kermit server and eating in a restaurant is that with Ker¬ 
mit, before you can order anything you have to visit the kitchen briefly and install the 
chef. Once installed, your chef no longer talks to you directly, but only to the waiter, who 
translates your order into the colorful restaurant jargon that only the chef understands. 
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Before you can “eat out,” you need two things: one Kermit program that can act as a serv¬ 
er (the chef), and another one (the waiter) that knows how to talk to the server. The com¬ 
puter jargon for the waiter is “client.” The Kermit client is usually the local Kermit, and 
the server is usually on the remote end. C-Kermit can act as either a client or a server. 


Starting the Server 


Here is the one and only command you need to put your chef to work: 

SERVER 

Tells the Kermit program to enter server mode using current communication and 
protocol settings. The prompt disappears, and all further communication takes place 
using Kermit protocol packets. 


Here’s an example in which your local computer is a PC running MS-DOS Kermit, and 
you start a C-Kermit server on a remote UNIX computer: 


MS-Kermit> connect 
login: olga 
Password: _ 

$ kermit 
C-Kermit>server 


(Connect to the remote computer) 
(Login if necessary) 


(Start Kermit) 

(Put it in server mode) 


Entering server mode. If your local Kermit software is menu driven, use 
the menus to send commands to the server. Otherwise, enter the escape 
sequence to return to your local Kermit prompt and issue commands from 
there. Use SEND and GET for file transfer. Use REMOTE HELP for a list of 
other available services. Use BYE or FINISH to end server mode. 


KERMIT READY TO SERVE... 

Alt-x (Escape back to PC) 

MS-Kermit> 

From this point, you may conduct all further business from your local Kermit’s prompt. If 
you try typing commands before you escape back, nothing will happen: the characters you 
type are not likely to be valid Kermit packets, so the server ignores them. In an emer¬ 
gency, however, you can get back to the C-Kermit command prompt by typing two 
Ctrl-C’s in a row: 

C-Kermit> server (Put C-Kermit in server mode) 

Entering server mode. If your local Kermit software is menu driven, use 
the menus to send commands to the server, otherwise, enter the escape 
sequence to return to your local Kermit prompt and issue commands from 
there. Use SEND and GET for file transfer. Use REMOTE HELP for a list of 
other available services. Use BYE or FINISH to end server mode. 


KERMIT READY TO SERVE... 

Ctrl-C Ctrl-C (Type Ctrl-C twice) 

'C .. . 

C-Kermit> (The prompt comes back) 
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Sending Commands to Kermit Servers 


To use the server, you must know what services it offers: 

REMOTE HELP 

Tells the local Kermit to ask the remote server for a list of the services it offers. In 
this example, an MS-DOS Kermit client queries a C-Kermit server: 

MS-Kermit> remote help 
C-Kermit Server REMOTE Commands: 

GET files REMOTE CD [dir] REMOTE DIRECTORY [files] 

SEND files REMOTE SPACE [dir] REMOTE HOST command 

MAIL files REMOTE DELETE files REMOTE WHO [user] 

BYE REMOTE PRINT files REMOTE TYPE files 

FINISH REMOTE HELP REMOTE SET parameter value 

If the client Kermit has these commands, the C-Kermit server will obey them. Other Ker¬ 
mit servers might have different menus. 


The first interactive Kermit command you learned was exit. The first command you 
should learn for controlling a Kermit server is the one that takes it out of server mode: 

FINISH 

Sends a command packet from a Kermit client to a Kermit server. This packet in¬ 
structs the server to exit server mode and return to its interactive Kermit prompt. 
Example: 

MS-Kermit >finish (Shut down the server) 

MS-Kermit> connect (Go back) 

C-Kermit> (C-Kermit's prompt has returned) 

A similar command makes the entire remote session just go away: 

BYE 

Tells the client Kermit program to send a command packet to a Kermit server. This 
packet tells the server to destroy itself and log out the session or job under which it is 
running and hang up the connection. 


Let’s practice starting and stopping a remote C-Kermit server a few times from a PC: 


MS-Kermit> connect 
login: olga 
Password: 


(Connect to the remote computer) 
(Log in) 

(Supply your password) 


$ kermit 
C-Kermit>server 


(Start Kermit) 

(Put it in server mode) 


Entering server mode. If your local Kermit software is menu driven, use 
the menus to send commands to the server. Otherwise, enter the escape 
sequence to return to your local Kermit prompt and issue commands from 
there. Use SEND and GET for file transfer. Use REMOTE HELP for a list of 
other available services. Use BYE or FINISH to end server mode. 
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KERMIT READY TO SERVE... 

help 

exit 

Alt-X 

MS-Kermit> finish 
MS-Kermit> connect 
C-Kermit server done 
C-Kermit> 
C-Kermit>server 


(Type commands to the server) 
(See how it ignores them) 

(Escape back to PC) 

(Shut down the server) 
(Connect again) 

(The prompt is back) 

(Start the server again) 


Entering server mode. If your local Kermit software is menu driven, use 
the menus to send commands to the server. Otherwise, enter the escape 
sequence to return to your local Kermit prompt and issue commands from 
there. Use SEND and GET for file transfer. Use REMOTE HELP for a list of 
other available services. Use BYE or FINISH to end server mode. 


KERMIT READY TO SERVE... 

Ctrl-C Ctrl-C (Type 2 Ctrl-C's) 

A C~C... 

C-Kermit> (Prompt reappears) 

C-Kermit> server (Start the server again) 

Entering server mode. If your local Kermit software is menu driven, use 
the menus to send commands to the server. Otherwise, enter the escape 
sequence to return to your local Kermit prompt and issue commands from 
there. Use SEND and GET for file transfer. Use REMOTE HELP for a list of 
other available services. Use BYE or FINISH to end server mode. 


KERMIT READY TO SERVE... 

Alt-X (Escape back to PC) 

MS-Kermit >bye (Terminate the remote session) 

C> 


Transferring Files with a Server 

Now that you know how to start and stop the server, let’s put it to work. Here are the 
basic commands for transferring files, which you would give to your local client Kermit 
program’s prompt, after putting the remote Kermit program in server mode and escaping 
back to the local Kermit program: 

SEND filespec [ remote-filename ] 

Sends the file or group of files named by filespec to the server. This is exactly the 
same command that you use to send files to a Kermit program that has been given the 
receive command and it works the same way in every respect (see Chapter 5). 

MSEND filespec [ filespec [...]] 

You can also use the msend command to send a selected group of files to the server, 
each under its own name. 

GET filespec 

Asks the Kermit server to send the file or file group specified by filespec. The file 
specification is expressed in the syntax of the server’s computer. 


142 Using a Kermit Server / Chapter 7 



The GET command is quite different from the RECEIVE command. Unlike the RECEIVE 
command, which passively waits for a file to arrive from another Kermit that has been 
given a send command, the GET command actively requests a particular file with a 
“please send me” protocol message containing the file’s name. If you give a RECEIVE 
command instead, the server doesn’t know what file you want: 

MS-Kermit> receive (This should have been GET) 

Protocol Errors Did you say RECEIVE instead of GET? 

MS-Kermit> 


A special form of the GET command lets you ask for a file and then store it under a dif¬ 
ferent name. Just type carriage return (press the key marked Return or Enter) immediately 
after the word GET, and Kermit prompts you for the remote and local names separately: 
MS-Kermit >get 

Remote source files foo bar b 
Local destination files foo.bar 

You can use wildcards in both send and GET commands. Wildcards in the get command 
must be in the notation of the computer that the server is running on. 

When C-Kermit itself is the server, your get command can include a single filename, a 
wildcard filename, or a list of any mixture of these. The C-Kermit server will send all the 
files in a single operation: 

MS-Kermit >get ck*.c *.h -olga/oofa.doc 

The file specifications are separated by spaces. If you need to include a space in a 
filename, use \32 (backslash followed by the ASCII code for space), for example (when 
asking a VMS C-Kermit server to send a file that resides on another DECnet node): 

MS-Kermit> get node"USER\32PASSWD"::dev:[dir]name.ext 
If you need to include a backslash in the filename, use two of them. 


When both Kermit programs are capable of transmitting the file type in an Attribute 
packet (see Chapter 8), you can switch between text and binary mode as often as you like 
when sending files to the server: 


MS-Kermit >set file type text 
MS-Kermit> send oofa.txt 
MS-Kermit> send a:mskermit.ini 
MS-Kermit> send \autoexec.bat 
MS-Kermit> set file type binary 
MS-Kermit> send *.exe 
MS-Kermit>send ‘.corn 


(Text files) 

(Send a file) 

(Send another file) 

(And another) 

(Now send binary files) 

(Send all my exe files) 

(Send all my com files) 

a VMS or Open VMS system, it can send a mix- 


(A mixture) 


When the C-Kermit server is running on 
ture of text and binary files in a single operation: 
MS-Kermit> get kermit. 
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When sending files in response to the GET command on other operating systems (such as 
UNIX), the C-Kermit server has no way to differentiate between text and binary files 
automatically, so it sends them in its current mode, TEXT or BINARY. 

The SET SERVER Command 

Normally the C-Kermit server silently waits for commands to arrive from the client 
program. You can make it time out and send NAK packets at periodic intervals during 
this period by using the command: 

SET SERVER TIMEOUT seconds 

This is useful if the client program is not capable of timing out. If SECONDS is 0, there are 
no timeouts during server command wait. 

If C-Kermit is in local mode and has been given a server command, it normally does not 
produce a file transfer display. If you want it to, tell it: 

SET SERVER DISPLAY ON 

This enables whatever type of display you have chosen in your most recent set file 
DISPLAY command (serial by default). 

File Management Services 

So far, we’ve only seen the Kermit server as a new way of doing the same old 
thing—transferring files. But you can also use the server for remote file management, just 
as you can use C-Kermit for local file management by giving it DIRECTORY, DELETE, and 
similar commands. The difference is the word remote. The remote prefix lets you send 
the commands to the remote Kermit server instead of executing them locally: 

MS-Kermit> delete data■tmp (Delete a local file) 

MS-Kermit >remote delete data.tmp (Delete a remote file) 

The DELETE command deletes a file on your local computer; the REMOTE delete com¬ 
mand asks the remote Kermit server to delete a file on its computer. 

REMOTE HELP 

This command asks the server to send you a list of all the commands it can respond to, 
as in the example on page 141. 

REMOTE CD [ directory ] 

Tells the client Kermit program to ask the Kermit server to change its default (work¬ 
ing) directory to the one given. If none is given, it changes to your home or login 
directory on the server’s computer. Examples: 

MS-Kermit> remote cd /usr/include (UNIX) 

MS-Kermit> remote cd sys$system (VMS or OpenVMS) 

MS-Kermit >remote cd (Default directory) 
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REMOTE DELETE filespec 

Tells the client Kermit program to ask the Kermit server to delete the specified file or 
files on the server’s computer. Normal access restrictions apply—the server can’t 
delete a file that you could not delete yourself. Example: 

MS-Kermit> remo del *.tmp (Delete all my .tmp files) 

REMOTE DIRECTORY [filespec)] 

Tells the client Kermit program to ask the Kermit server to send a directory listing of 
the specified file or files to your screen. The filespec is in the syntax of the Kermit 
server’s operating system. If no filespec is given, the server sends a directory listing 
of all files in its current directory. The format of the listing depends on the server 
Kermit’s underlying operating system. 

MS-Kermit >remo dir *.txt (List all my txt files) 

MS-Kermit> rem dir (All files in current dir) 

MS-Kermit >rem dir [ivan] (A different directory) 

When the server is C-Kermit running under UNIX, VMS, Open VMS, or OS/2, you 
can include directory command qualifiers in your remote directory command after 
the words remote directory and before the file specification (if any): 

MS-Kermit >remo dir -t *.txt (UNIX, reverse time order) 

MS-Kermit >rem dir /o-d *.txt (OS/2, reverse time order) 

MS-Kermit >rem dir /size /date (VMS, include size and date) 

REMOTE SPACE [ device!directory ] 

Tells the client Kermit program to ask the Kermit to give a brief report on space used 
or available on the given device or directory, or if none is given, in the server’s current 
device or directory. Examples: 

MS-Kermit >remot space /usr (UNIX, /usr partition) 

MS-Kermit> remo spac sys$login (VMS, login disk) 

MS-Kermit >rem spa a; (OS/2, A: disk) 

MS-Kermit> rem spa (Any, current disk) 

REMOTE TYPE filespec 

Tells the client Kermit program to ask the Kermit server to display the specified file 
on your screen. The file is assumed to be a text file. Example: 

MS-Kermit> remote type oofa.txt 

These commands are the same regardless of the machine or operating system of the serv¬ 
er. They are translated by your local Kermit into standard protocol messages understood 
by all Kermit servers that support these commands. If you send a command that is not in 
the server’s repertoire, the server responds with a message like “Unimplemented server 
command.” 
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Fun with Servers 

Kermit servers have a few extra capabilities besides ordinary file transfer and manage¬ 
ment. You can use the following commands if both your local Kermit and the remote 
server support them: 

REMOTE WHO [ user ] 

Tells the client Kermit program to ask the Kermit server to send information about a 
particular user of its computer, or if the computer is on a network, about any user on 
any computer on the network. If no user is specified, the server sends a list of all users 
who are currently logged in. Examples: 

MS-Kermit> remote who (All logged-in users) 

MS-Kermit> remote who olaf (A particular user) 

MS-Kermit> remote who kermitgwatsun (A user on the network) 

REMOTE HOST command 

Tells the client Kermit program to ask the server to ask its host operating system to ex¬ 
ecute the given command and return the results to your screen. The command must 
not require a dialog; it has to be the sort of command that you can give to your host 
operating system completely on one line and that responds by printing a message on 
your screen using ordinary characters—not graphics—or by not printing anything, and 
then exits. Examples: 

MS-Kermit> remote host copy oofa.old oofa.new 
MS-Kermit> remo hos date (UNIX date and time) 

Sat Jul 4 18:42:43 EDT 1992 

MS-Kermit> rem ho show time (VMS date and time) 

4-JUL-1992 18:42:43 

MS-Kermit> remote host mkdir temp (Create UNIX directory) 
MS-Kermit> remo ho create/dir temp (Create VMS directory) 

If you invoke any other kind of program with REMOTE HOST, the results are unpredict¬ 
able, and probably not what you wanted. 

REMOTE KERMIT text 

Tells the client Kermit program to send the text to the server, which is to interpret it as 
if it were a Kermit command typed at its own Kermit prompt. C-Kermit can send this 
command as a client, but a C-Kermit server cannot respond to it. 

REMOTE LOGIN name password [ account ] 

Tells the client Kermit program to send user ID and password (and optionally, ac¬ 
count) information to a Kermit server. Some Kermit servers (C-Kermit not among 
them) can be set up to require login before they will respond to any other commands. 

REMOTE LOGOUT 

Terminates your access rights with a Kermit server that you have previously accessed 
via REMOTE LOGIN. 
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REMOTE PRINT filespec [ options ] 

Sends the specified local file to the Kermit server and asks the Kermit server to print it 
using the specified options, if any. The options are in the syntax of the server’s host 
operating system. If no options are specified, the server system’s defaults are used: 

MS-Kermit> remote print oofa.txt /queue=laser /copies=3 (VMS) 
MS-Kermit> remo prin oofa.txt -Plaser -#3 (UNIX) 

MS-Kermit> rem pri oofa.txt 

MAIL filespec address 

Sends the specified local file to the Kermit server, and asks the server to deliver it as 
electronic mail to the specified address rather than storing it on disk. Examples: 

MS-Kermit >mail oofa.txt olga, ivan 
MS-Kermit> mail messaqe.txt info-kermit@watsun 


Interrupting Server Operations 

send, msend, and get can be interrupted in the normal way: X to cancel a file, Z to can¬ 
cel a group, and so on (see Chapter 5). Most remote commands can be interrupted in this 
way too. You can also CONNECT to the C-Kermit server and type two Ctrl-C’s. 

Changing the Server’s Settings 

If your server allows it (as C-Kermit does), and your local Kermit program has the com¬ 
mands for it (both C-Kermit and MS-DOS Kermit do), you can change the remote server’s 
settings by giving commands to the client program: 

REMOTE SET parameter value 

Tells the Kermit client to ask the remote Kermit server to set the given parameter to 
the specified value. The parameters include many of the same ones used in the SET 
command, like BLOCK-CHECK, FILE TYPE, and so forth. Issuing the REMOTE SET com¬ 
mand to your local Kermit program is exactly like issuing the corresponding SET com¬ 
mand to the remote Kermit program if it were in interactive command mode. Here is 
an example in which we switch a Kermit server from sending files in text mode to bi¬ 
nary mode (remember, it is the file sender that controls the transfer mode): 

MS-Kermit> qet *.txt (Get text files) 

MS-Kermit> remote set file type binary 
MS-Kermit> qet *.bin (Get binary files) 

To see a complete list of remote SET commands supported by your client Kermit 
program, just type REMOTE SET followed by a space and a question mark. Here is an ex¬ 
ample for MS-DOS Kermit: 

MS-Kermit> remote set ? One of the following: 
attributes file incomplete block-check receive retry 
server transfer window-slots 

MS-Kermit>remote set attributes date off 
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These are the remote set commands an MS-DOS Kermit client can send to a Kermit 
server. As with the local set command, some of these commands have further options: 

MS-Kermit>remote set receive ? One of the following: 

packet-length timeout 
MS-Kermit>remote set receive timeout 8 
MS-Kermit> 

When C-Kermit itself is the client, it can send the following remote set commands to a 
Kermit server: 

C-Kermit >remote set ? One of the following: 
attributes block-check file incomplete 

receive retry server transfer 

window 
C-Kermit> 

And when C-Kermit is the server, it also allows these commands to be sent to it. If you 
send a remote set command to a Kermit server that does not support this feature, it 
replies with an error message like “Unimplemented server function” or “Unknown 
REMOTE SET parameter.” 


Server Security 


You can control access to the C-Kermit server’s services on an individual basis with the 
DISABLE and ENABLE commands. All services are enabled by default. 

DISABLE service 

Instructs the server not to perform the named service. 

ENABLE service 

Reinstates a service that was previously disabled. 

Here are the services that can be disabled and enabled. The effect of disabling each ser¬ 
vice is described. Enabling a service removes all restrictions that were imposed when you 
DISABLEd it. If you want to disable certain functions, be sure to give the appropriate 
DISABLE commands before you give the SERVER command. 

DISABLE BYE 

Ignore BYE commands; remain in server mode. Example: 

C-Kermit> disable bye (Don't let them log me out) 

C-Kermit>server (Enter server mode) 

C-Kermit server starting, blah blah blah ... 

Alt-x (Escape back) 

MS-Kermit> bye (Try to log out the server) 

Protocol Error: BYE disabled 

MS-Kermit> 
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The server remains in server mode, ready to accept any commands that have not been 
disabled. 

DISABLE CD 

Disallow changing of the default device and/or directory. Don’t allow files to be 
transferred into or out of any but the current device/directory. Don’t allow files out¬ 
side the current directory to be listed, deleted, or typed. 

DISABLE DELETE 

Ignore REMOTE DELETE commands. 

DISABLE DIRECTORY 

Ignore remote directory commands. 

DISABLE FINISH 

Ignore finish commands; remain in server mode. 

DISABLE GET 

Ignore GET commands; don’t send files. 

DISABLE HOST 

Ignore remote host commands. 

DISABLE SEND 

Refuse to receive files when the client Kermit tries to SEND them. 

DISABLE SET 

Ignore REMOTE SET commands. 

DISABLE SPACE 

Ignore remote space commands. 

DISABLE TYPE 

Ignore remote type commands. 

DISABLE WHO 

Ignore remote who commands. 

You can find out which services are enabled and disabled with the SHOW SERVER 
command. For example, in C-Kermit: 

C-Kermit> sho server 
Function Status: 


GET 


enabled 

SEND 


enabled 

REMOTE 

CD/CWD 

enabled 

REMOTE 

DELETE 

enabled 

REMOTE 

DIRECTORY 

enabled 

REMOTE 

HOST 

enabled 
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REMOTE SET 
REMOTE SPACE 
REMOTE TYPE 
REMOTE WHO 
BYE 

FINISH 

Server timeout: 
Server display: 


enabled 

enabled 

enabled 

enabled 

disabled 

enabled 

0 

off 


CAUTION: Some of these commands, including delete, directory, SPACE, type, and 
WHO, are also accessible via REMOTE HOST. If you want to prevent users from accessing 
these services through the server, you must disable host too. 


Turning the Tables 


Now that you can control a remote Kermit server from your local computer, can you think 
of a reason why you might want to control a local Kermit server from a remote Kermit 
client? Suppose you want to send a mixture of text and binary files from a remote UNIX 
computer to your local PC. Here is one way to do it. Connect and login to the remote 
computer from your local PC. Then use your UNIX text editor to create a command file 
for UNIX C-Kermit containing the necessary SET FILE TYPE and SEND commands, as in 
this example, called xf er. tak: 


echo Return to your local Kermit and give the SERVER command, 
set delay 5 ; Allow time to escape back 

set file type binary ; Binary for object and executable files 
msend *.o wermit 

set file type text ; Text for source files 
msend *.c *.h 


finish 


Return the PC to normal 


The finish command makes the MS-DOS Kermit’s prompt reappear after all the files 
have been transferred. 


Now start C-Kermit on the VAX, have it TAKE the command file, then escape back to the 
PC and put MS-DOS Kermit into server mode: 

C-Kermit >take xfer.tak (TAKE the command file) 

Return to your local Kermit and give the SERVER command. 

Alt-x (Escape back to the PC) 

MS-Kermit >serve (Put it in server mode) 

And now go to lunch while all the files are being transferred. This has been our first 
glimpse into Kermit’s capabilities for unattended operations. If you are intrigued, be sure 
not to skip Chapters 11 through 13. 
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Chapter 8 


File Transfer Power Tools 


In this chapter, we’ll take a look at some advanced features of the Kermit protocol that can 
save you time and effort: efficiency boosters like long packets, sliding windows, and 
locking shifts, and the Attribute-Packet mechanism that one Kermit uses to tell the other 
some key facts about the files that are being transferred. But before you can use these fea¬ 
tures, you need to know a little bit about the Kermit protocol itself. 

Overview of the Kermit Protocol 


When you transfer a file, Kermit breaks it up into a series of messages called packets. 
Each packet consists of distinct start and end markers; a length field for framing; a se¬ 
quence number for detection of missing, duplicated, or out-of-sequence packets; a packet 
type; some data; and a checksum for error detection, as shown in Figure 8-1. 

Except for the start and end markers (normally Control-A and Carriage Return, respec¬ 
tively), the packets are encoded by the sender as simple lines of printable text to survive 
even the most hostile communication environments, and decoded by the receiver into the 
appropriate form. 


<START> 


LEN 

SEQ 

TYP 

DATA 

CHK 


<END> 


Figure 8-1 Kermit Packet Format 
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I Packet 01 -► 

* - 1ACK 0 | 

[ Packet 1 | -► 

-- [ ACK 1 | 

I Packet 21 --- - | Pad&t 21 

* - [ NAK 2 | 

[ Packet 2 1 -*• 

* - 1 ACK 2 1 

I Packet 31 - *■ 

* - 1 ACK 3 1 

I Packet 41 -► 

* - 1 ACK 4 | 

I Packet 5 1-*- 

* - 1 ACK 5 | 

Figure 8-2 Stop-and-Wait Packet Exchange 


The file sender sends packets of various types, and the file receiver replies to each packet 
with an acknowledgement (ACK) to indicate that the packet was received correctly, or a 
negative acknowledgement (NAK) that tells the sender a packet was received in damaged 
condition—or not received at all—and therefore needs to be retransmitted. Because the 
file sender waits for an acknowledgement before sending the next packet, the rate at which 
packets are exchanged is controlled by the receiver, which prevents a fast sender from 
overrunning a slower receiver. This style of packet exchange is called “stop and wait,” 
and is illustrated in Figure 8-2. Of course, neither Kermit program stops and waits 
forever. If an expected packet does not arrive within the timeout interval, there is an 
automatic timeout and retransmission to break the deadlock. 

The packet exchange proceeds through the following phases, each of which is associated 
with a particular packet type, shown in parentheses (see Table 5-2 on page 108 for a more 
complete list of Kermit packet types): 

1. (S) Feature negotiation. By exchanging special packets, the two Kermits determine 
which features they have in common and agree to use them. This allows the newest, 
most full-featured version of Kermit to work automatically with even the oldest 
barest-bones version. 

2. (F) The file sender sends the file name so the receiver can create the new file with the 
same name. 

3. (A) The file sender sends information about the file (file attributes) so the receiver can 
create the file with the appropriate attributes, including size, creation date, type (text 
or binary), character set, and so forth. 
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4. (D) The file sender sends the contents (data) of the file, usually requiring many pack¬ 
ets. During the data phase, the Kermit protocol accomplishes the necessary conver¬ 
sions by translating between the local computer’s character codes and file formats and 
the standard ones specified by the protocol, so each computer only needs to know its 
own local conventions and the standard ones. 

5. (Z) When all the file’s data has been sent, the file sender sends an end-of-file packet so 
the receiving computer knows the file has been completely received and can close it. 

If there are more files to send, steps 2-5 are repeated for each file. 

6. (B) When all the files have been sent, the file sender terminates the operation by send¬ 
ing a “Bye” packet, causing each Kermit program to leave packet mode and return 
control to the user, with the local Kermit program notifying the user that the file has 
been completely transferred. 

Analyzing Kermit’s Performance 


After the file transfer is finished, you can use the statistics command to get information 
about its efficiency and what parameters were used: 


C-Kermit> stat 
Most recent transaction 
files; 6 

characters last file 
total file characters 
communication line in 
communication line out 
packets sent 
packets received 
damaged packets rec'd 
timeouts 
retransmissions 
parity 

8th bit prefixing 
locking shifts 
window slots used 
packet length 
compression 
block check type used 
elapsed time 
transmission rate 
effective data rate 
efficiency (percent) 
C-Kermit> 


109313 

452992 

25989 

489226 

5180 

5187 

4 

2 

7 

none 

no 

no 

1 of 1 

94 (send), 94 (receive) 
yes [-] (79010) 

1 

681 sec 
9600 bps 
665 cps 
69 


Let’s take a brief look at this report. It contains all the information needed to tune 
Kermit’s peformance. 


Analyzing Kermit’'s Performance 
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files; 6 

characters last file ; 109313 

total file characters : 452992 (/) 

This tells you how many files were transferred, as well as how many characters were 
in the last file, and in all the files. Let’s call this last number/. 

communication line in ; 25989 (/>■) 

communication line out : 489226 ( p 0 ) 

This tells you how many characters were received (p i ) and transmitted (p g ) on the 
communication device. The number of extra characters introduced by the Kermit 
protocol is: 

Pi+P 0 -f 

The encoding efficiency is the ratio of the file size to the total number of characters 
sent and received: 

/ 

Pi + Po 

which, in this case, comes out to 452992/(25989+489226) = 0.88. If this number 
is less than 1, there is a net expansion, and therefore a loss of efficiency. If it’s greater 
than 1, the data must have been compressed more than enough to compensate for the 
packet overhead. 


packets sent ; 5180 

packets received s 5187 

damaged packets rec'd : 4 

timeouts : 2 

retransmissions : 7 


This tells us how many packets were sent and received. The number of damaged 
packets is a good indicator of the cleanliness of the connection. A perfectly clean con¬ 
nection should have none. Timeouts can indicate either a very poor connection (bad 
enough to make a packet indistinguishable from line noise), long delays, or a timeout 
value based on an incorrect perception of the communication speed. The number of 
retransmissions is the number of times packets had to be sent again because of a 
timeout, because a NAK was received, or because a damaged packet was received. 

parity ; none 

8th bit prefixing : no 

locking shifts : no 

These items tell whether C-Kermit is operating in 7-bit or 8-bit mode. If PARITY is not 
NONE, you have a 7-bit connection, and 8-bit data is transmitted using single shifts 
(8th-bit prefixing) or locking shifts (described later) if these features are successfully 
negotiated (see Table 8-1 on page 168). Both of these methods add additional over¬ 
head and should be avoided when possible. 
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window slots used s 1 of 1 

packet length : 94 (send), 94 (receive) 

compression s yes [-] (79010) 

These are Kermit’s performance boosters. Keep reading this chapter to find out how 
to use them. 


elapsed time 

: 681 

sec 

(0 

transmission rate 

: 9600 

bps 

(r) 

effective data rate 

: 665 

cps 


efficiency (percent) 

: 69 


(e) 


This is Kermit’s report card 


69 percent. We’ll improve our score shortly, but first 


let’s see how it was calculated [19]: 


/x 10 
rxt 


where: 


e = efficiency, 1.00 is perfection 
/ = file size in characters 
t = elapsed time in seconds 
r = transmission rate, bits per second 


That is, the ratio of total file bits actually transferred to the number of bits that could 
possibly be transferred in the elapsed time. In our example, this is: 


452992x10 

9600x681 


0.6929 


or about 69 percent. 


Kermit’s small packet size and stop-and-wait technique of exchanging packets tend to 
result in this kind of performance. But this design lets Kermit protocol work on many 
types of connections where other protocols fail to work at all. Of course other factors 
must be considered in the performance too: the speed of the computers (CPU power, load 
on the system, disk access time, and so on), the quality of the connection (the number of 
retransmissions), and the delay properties of the connection. 


Improving File Transfer Performance 

There are several ways to improve the performance of Kermit file transfer: 

• Turn off the file transfer display 

• Increase the ratio of real data to packet overhead characters 

• Eliminate the wait between packets 

• Compress the data 
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In this section we present the tools you will need to accomplish each of these feats, one at 
a time or in any combination. 


The File Transfer Display 

C-Kermit’s local-mode fullscreen file transfer display can slow down the transfer 
measurably, particularly on high-speed network connections. You can often speed up the 
transfer by selecting a simpler display, such as CRT or serial, or, for maximum transfer 
speed, NONE. When C-Kermit is the remote, try similar techniques with your local Kermit 
program. For example, tell MS-DOS Kermit to SET display quiet. 


Long Packets 

Kermit data packets can be any length between about 20 and 9000 characters. 22 Normal 
Kermit packets are about 94 characters long, and C-Kermit uses this length unless told 
otherwise. As Figure 8-1 shows, each packet has five control fields in addition to the data, 
and each packet must be acknowledged by another packet that includes five control fields 
of its own, but (usually) no data. 


Kermit’s packet length is a major factor in its performance. The longer the packet, the 
higher the proportion of actual data to protocol overhead characters, and the fewer ac¬ 
knowledgements required. Under a certain set of conditions, you can increase Kermit’s 
file transfer efficiency as much as 800 percent by using longer packets (reference [19], 
page 13, Table 4). The trick is to find the ideal packet length for a given connection. The 
command that governs Kermit’s packet length is: 


SET RECEIVE PACKET-LENGTH number 

Give this command to the file receiver before the transfer starts. The file receiver 
gives permission to the file sender to send packets up to the given number of bytes 
(characters) in length. When you are using long packets, you should also use a 
stronger error-checking method, since the probability of undetected errors goes up 
with the packet length. Example: 


C-Kermit> set rec pack 2000 

C-Kermit >receive 

Alt-x 

MS-Kermit >set block-check 3 
MS-Kermit>send oofa.txt 


(Set the packet length) 
(Receive a file) 

(Escape back to the PC) 

(Use strong error checking) 
(Send a file) 


Remember, the set receive packet-length command works only when you give it to 
the file receiver. Of course, the file sender can decide to use shorter packets anyway, for 


22 The absolute limit is 95 2 -1 =9024, but some Kermit programs have a lower limit because of memory 
or addressing limitations. Use the show protocol command to find the maximum packet length of your 
Kermit program. 
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example if its maximum packet length is less than what the receiver asked for, or if it 
doesn’t support the long-packet extension to the Kermit protocol at all; see Table 1-1 on 
page 8. For that matter, you can even tell the file sender yourself: 

SET SEND PACKET-LENGTH number 

Give this command to the file sender. This is the maximum length packet to send. 
When the file transfer begins, the file receiver tells the sender the longest packet it is 
prepared to receive. The smaller of that number and the sender’s SET send packet- 
length value is used. 

Thus, it is impossible to force a Kermit program to send packets longer than the receiver 
asks for, but it is possible to force shorter ones. 


To find the optimum packet length for a given connection, select a moderate-size file and 
transfer it using different packet lengths. Note the efficiency (or, when the speed is not 
accurately known, as on a network connection, the effective data rate) reported by 
C-Kermit’s statistics command after each transfer. Use whatever packet length results 
in the highest performance. In this example, we use 2000-byte packets to transfer a 
53,000-byte text file: 


C-Kermit> set receive packet-len 2000 

C-Kermit>r 

Alt-}c 

MS-Kermit> set block 2 
MS-Kermit>s test.txt 


(Try 2000-byte packets) 
(Receive a file) 

(Escape back to PC) 

(Use 2-byte checksum) 
(Send the file) 


(The file is transferred) 


MS-Kermit>c 

C-Kermit>stat 


(Connect back) 
(Get statistics) 


packet length 
elapsed time 
transmission rate 
effective data rate 
efficiency (percent) 
C-Kermit> 


94 (send), 2000 (receive) 

61 sec 
9600 bps 
870 cps 

90 (Better than 69!) 


Dynamic Packet Length 

In a perfect world, it would make sense to use the longest possible packets all the time. 
But this is the real world. On a noisy connection, long packets can actually reduce the ef¬ 
ficiency of a file transfer: 

The longer a packet, the more likely it is to be damaged and 
the longer it takes to retransmit. 
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When C-Kermit is sending a file, it tries to compensate for noise on the communication 
line by reducing the packet length automatically whenever a packet is damaged or a 
timeout occurs, and then slowly increasing it again for each packet that is transmitted suc¬ 
cessfully: the packet length adjusts to the noise level [15]. This trick is not foolproof, 
however. If a packet is absolutely, positively too long for the receiver’s or network’s buf¬ 
fers, it will never get through. The only remedy in this case is to start again with a shorter 
maximum packet length. 


Sliding Windows 

On a clean direct or dialed connection, long packets are probably all you need to achieve 
good performance. But suppose you have a long-distance connection through a public 
packet-switched network or an earth satellite. It might take a second or more for a packet 
to reach its destination and just as much time for an acknowledgement to make the return 
trip. Or suppose you have a no-delay connection that is noisy or in which there are 
buffer-size limitations. Kermit’s sliding window option is designed for these situations. 


Kermit’s normal packet protocol is: send packet number n, wait for an acknowledgement 
for packet n, then send packet n+ 1, and so on, as you saw in Figure 8-2. When the con¬ 
nection has a long round-trip delay, the waiting time destroys the efficiency of the 
protocol. For example, on a 9600 bps connection with 1 second delay, where one tenth of 
a second is required to transmit a 94-byte packet, the waiting time could have been used to 
transmit 9 more packets. Efficiency plummets to about 10 percent, as in this example, 
using the same 53K file as before: 

C-Kermit >set rec pack 94 
C-Kermit>c 
Alt-x 

MS-Kermit> send test.txt 

(The file is transferred) 

MS-Kermit>c (Connect back) 

C-Kermit >stat (Get statistics) 


(No long packets) 
(Receive a file) 
(Escape back to PC) 
(Send a test file) 


packet length 
elapsed time 
transmission rate 
effective data rate 
efficiency (percent) 
C-Kermit> 


94 (send), 94 (receive) 
686 sec 
9600 bps 
77 cps 

8 (Terrible!) 


That’s 11 minutes to transfer the file at 8 percent efficiency, when you would expect to be 
able to transfer it in about a minute. If you are using a modem, you can watch the receive 
and transmit lights to appreciate what’s happening: the transmit light blinks on for a brief 
moment, then both lights go dark. After a long pause, you get a blip on the receive light, 
followed immediately by a blip on the transmit light, then another long pause. And so on. 
More than 90 percent of the time is wasted. 
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Let’s try the same transfer again with 1000-character packets to see how much long pack¬ 
ets might help. Here we just show the statistics: 

C-Kermit>stat (Get statistics) 


packet length 
window slots used 
elapsed time 
transmission rate 
effective data rate 
efficiency (percent) 
C~Kermit> 


94 (send), 1000 (receive) 

1 of 1 

117 sec 

9600 bps 

451 cps 

47 


Much better, but still less than half the transmission speed. The long intervals of dead air 
remain between each packet, only now we have fewer of them. 


The inter-packet waiting time can be eliminated if the normal stop-and-wait rule is relaxed 
to let Kermit send packet n+ 1 before packet n's acknowledgement arrives. C-Kermit is so 
relaxed about this rule it can happily tolerate as many as 31 outstanding packets, using the 
sliding window technique [18] illustrated in Figure 8-3. 


I Packet 0 


I Packet 1 


] Packet 2 


1 Packet 3 


1 Packet 4 


1 Packet 5 

- 

I Packet 6 

-- ► 

I Packet 7 


1 Packet 8 


1 Packet 9 

. > 

1 Packet 10 


I Packet 11 


1 Packet 6 


1 Packet 12 


1 Packet 13 


1 Packet 14 

-- 


\ ACK 0 I 
\ ACK 1 I 
{ ACK 2 1 
{ ACK 3 1 
{ ACK 4 | 
i ACK 5 I 
{ NAK 6 j 
{ ACK 7 1 
{ ACK 8 I 
{ ACK 9 I 
jACK 10| 
{ACK 111 
] ACK 6 I 
jACK 121 
1 ACK 131 
■ I ACK 14 | 


Figure 8-3 Sliding Windows 
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SET WINDOW number 

Specifies how many packets, 1 to 31, may be transmitted before acknowledgements 
arrive. With a sufficiently large window size, Kermit can (usually) transfer packets 
continuously. It is necessary to give a SET window command to both Kermit pro¬ 
grams in order to make this feature work. If the window sizes differ, the smaller of 
the two is used. If the other Kermit does not support sliding windows at all, normal 
stop-and-wait packet exchange is used automatically, which is equivalent to using a 
window size of 1. 


Let’s see if we can pep up our connection with a combination of long packets and sliding 
windows. Here we transfer the same file again, over the same long-distance connection: 


C-Kermit> set rec pack 500 
C-Kermit >set window 4 
C-Kermit>r 
Alt-x 

MS-Kermit> set window 4 
MS-Kermit> send test.txt 

(The file is transferred) 

MS-Kermit>c 
C-Kermit>stat 


packet length 
window slots used 
elapsed time 
transmission rate 
effective data rate 
efficiency (percent) 
C-Kermit> 


(Packet-length is 500) 
(Use four window slots) 
(Receive a file) 

(Escape back to PC) 
(Select window size) 
(Send the file) 


(Connect back) 

(Get statistics) 

500 (receive) 


94 (send) 
2 of 4 
65 sec 
9600 bps 
816 cps 
85 


That’s more like it! Don’t be alarmed if the file receiver reports a smaller number of win¬ 
dow slots used than the file sender. This is normal. The file sender sends packets as fast 
as it can until its window fills up or an ACK arrives; the file receiver, however, gets the 
packets in order and ACKs each one when it arrives. The receiver’s window is used only 
when packets are received in damaged condition or out of order. 


Sliding windows can be beneficial even when the connection has no delays at all. First, 
sliding windows eliminate the ACK/NAK overhead. The ACKs and NAKs are on the 
wire simultaneously with the data packets, so they don’t take up any extra time. Second, 
sliding windows can give better results than long packets on noisy connections. Remem¬ 
ber the rule for long packets: The longer a packet, the more likely it is to be damaged and 
the longer it takes to retransmit. 

When sliding windows are in effect and a packet is damaged or lost (perhaps it was stolen 
by a pick-packet?), the Kermit protocol recovers by selective retransmission, meaning that 
only the damaged packet is retransmitted, as with Packet 6 in Figure 8-3. If packets are 
short, they are less likely to be damaged and take less time to retransmit. 
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But when the connection is clean and unobstructed, we can use long packets and sliding 
windows together to obtain optimum results, as in this example with a window size of 2 
and a packet length of 4000: 

C-Kermit> stat 

packet length 
window slots used 
elapsed time 
transmission rate 
effective data rate 
efficiency (percent) 

C-Kermit> 

For typical text files, 96 percent is just about the optimum Kermit file transfer efficiency. 
To achieve this level on a particular connection, experiment with different combinations 
of packet length and window size. 


57 sec 
9600 bps 
921 cps 
96 


Windows and Buffers 

If sliding windows are so beneficial, perhaps you are wondering why the SET window 
command is necessary at all. Why not use a window size of 31 all the time? First of all, 
many packets sent in a continuous stream could have the same ill effect as a very long 
packet when computers or networks have small buffers: fatal indigestion. 

Second, most Kermit programs have a limited amount of memory for packet buffers. To 
use sliding windows, Kermit must keep all windowed packets in memory simultaneously 
so selected packets can be retransmitted and out-of-order packets can be sorted before 
writing their contents to disk. If the total packet buffer memory available is less than the 
product of the maximum packet size and the maximum window size (9024 x 31 = 279744 
bytes plus some extra), then the window size or the packet size must be reduced. 

Most implementations of C-Kermit are set up to allow packet buffers to be allocated 
dynamically. You can increase the overall packet buffer size using the command: 

SET BUFFERS send-length receive-length 

Allocates the specified number of bytes of memory for send and receive packet buf¬ 
fers, respectively. Example: 

C-Kermit> set receive packet-len 9000 
C-Kermit> set window 31 

Adjusting receive packet-length to 286 for 31 window slots 
C-Kerinit> show protocol 

Receive packet-length: 286, Windows: 31, Buffers: 9065 9065 
C-Kermit> set buffers 280000 280000 
C-Kermit> set rec pack 9000 
C-Kermit> show protocol 

Receive Packet-length: 9000, Windows: 31, Buffers: 280015 280015 
C-Kermit> 
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If Kermit can’t find the memory you asked for, the command fails. If the set BUFFERS 
command gives a syntax error, your version of C-Kermit does not have this feature at all: 

C-Kermit> set buffers 280000 280000 
?No keywords match - buffers 
C-Kermit> check dynamic 
Not available 
C-Kermit> 

Now perhaps you are wondering why the SET buffers command is necessary. Why not 
always allocate 279744 bytes of memory for each kind of buffer and be done with it? The 
answer is simple: different computers have different amounts of memory available, dif¬ 
ferent memory allocation strategies, different strategies for paging and swapping, and so 
forth. On some computers (but not others), allocating a lot of memory for packet buffers 
can result in extremely poor performance: just the opposite of what you wanted. So once 
again the onus is on you to find the numbers that are just right for your computer. 

Single Shifts 

When Kermit transfers 8-bit data over a 7-bit connection, it uses a single-shift method. 
Each 8-bit character is preceded by a special prefix character, normally ampersand (&), 
that tells the receiving Kermit to put back the 8th bit. This 8-bit transparency technique is 
supported by virtually all Kermit versions (see Table 1-1 on page 8). It is negotiated auto¬ 
matically; C-Kermit bids to use this option if its PARITY is set to any value other than 
NONE, and agrees to use it whenever the other Kermit asks for it. Otherwise, the 8th bit of 
each data byte is preserved. C-Kermit has no command, other than SET PARITY, to control 
the use of single shifts. 

Since 8-bit characters occur either not at all, or else more or less randomly, in most types 
of files, this simple approach lets the data get through without too much extra overhead. 
The penalty is approximately zero for ASCII text, about 5 percent for text written in 
European languages, and 50 percent for non-textual binary files that contain a uniform dis¬ 
tribution of 8-bit byte values. 

Locking Shifts 

Certain types of files can have long sequences of 8-bit bytes. The most common examples 
are text files written in a non-Roman alphabet and encoded in character sets like Latin/ 
Cyrillic, Latin/Greek, Latin/Hebrew, Latin/Arabic, and especially the EUC encoding for 
Japanese Kanji. 23 The penalty for single-shift encoding in typical Cyrillic text is about 80 
percent, and for EUC Kanji it is very close to 100 percent. 


23 Character sets are explained in Chapter 9. 
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When you need to transfer this type of file over a 7-bit connection, C-Kermit uses locking 
shifts [31] as well as single shifts if the other Kermit program agrees. A locking shift is a 
special character, Ctrl-N (Shift-Out, SO), that means that all the following characters up to 
the next Ctrl-O (Shift-In, SI) are to have their 8th bits set to 1 upon receipt: 24 

Seven-bit-text<SO>Eight-bit-text<SI>Seven-bit-text 

While encoding data to be sent, in each case C-Kermit decides whether it is more efficient 
to use a locking shift or single shift. 

The use of this option is almost never bad. At worst, performance is the same with it as 
without it (as with 7-bit text files and 8-bit binary files). In some cases (particularly for 
Kanji and Cyrillic text), it produces a dramatic increase in efficiency, as much as 100 per¬ 
cent. The use of locking shifts is controlled by a SET command: 

SET TRANSFER LOCKING-SHIFT { OFF, ON, FORCED } 

Specifies whether or how locking shifts should be used by Kermit for encoding and 
decoding packets. Synonym: SET XFER LOCKING-SHIFT. The options are: 

ON: This is the default setting. If parity is not none C-Kermit tries to negotiate the 
use of locking-shift protocol with the other Kermit, and uses it if the other Kermit 
agrees. If parity is NONE, locking shifts aren’t used unless the other Kermit re¬ 
quests them. 

OFF: Don’t use locking shifts, regardless of the parity setting. If the other Kermit 
asks for locking shifts, C-Kermit refuses. 

FORCED: Use locking shifts, regardless of the PARITY setting and negotiations. For 
the file sender, this command lets data be sent to a receiver that doesn’t understand 
locking shift protocol; the embedded SO and SI characters are stored in the 
received file, where they can be processed by terminals, printers, and other 
devices. For the file receiver, this command forces the treatment of SO and SI 
characters in the data as shift commands. This option automatically disables the 
use of single shifts. 

To illustrate the usefulness of locking shifts, let’s try transferring a Japanese Kanji text file 
through a 7-bit connection without them (notice how the STATISTICS command tells 
whether locking shifts were actually used): 

C-Kermit> set parity even 

C-Kermit> set file character-set shift-jis 
C-Kermit> set xfer character-set japanese 
C-Kermit> set xfer lockinq-shift off 


24 The Ctrl-N and Ctrl-O characters are, of course, encoded as printable characters, #N and #o, during 
packet transmission. 
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C-Kermit> send kanji.txt 

C-Kermit> statistics 
total file characters 
communication line out 
8th bit prefixing 
locking shifts 
elapsed time 
efficiency (percent) 

C-Kermit> 

and with them: 

C-Kermit> set parity even 

C-Kermit> set file character-set shift-jis 
C-Kermit> set xfer character-set japanese 
C-Kermit> set xfer locking-shift on 
C-Kermit> send kanji.txt 

C-Kermit >stat 
total file characters 
communication line out 
8th bit prefixing 
locking shifts 
elapsed time 
efficiency (percent) 

C-Kermit> 

Nearly twice as fast. So... 

When you’re in Japan or the (ex)-USSR 
And your file transfers need a lift, 

Remember the old football cheer: 

Lock that Shift! Lock that Shift! Lock that Shift! 

Data Compression 

Long packets, sliding windows, and locking shifts have SET commands to govern whether, 
how, or how much they are to be used because each one has drawbacks as well as ad¬ 
vantages. But there is one feature you get for free: data compression. It has no dis¬ 
advantages, so there is no set command to turn it on and off. Whenever you initiate a file 
transfer, the sending Kermit asks the receiving Kermit if it can accept compressed data. If 
there is agreement, the file sender collapses repeated bytes into a sequence composed of a 
special compression lead-in character, a repeat count, and then the character itself. For 
example: 

-@C 

stands for 32 letter C’s in a row (- is the lead-in character, g is the encoded repeat count, 
and c is the letter C itself). 


29440 
32404 
yes [&] 
yes 

34 sec 
90 


: 29440 
: 58451 
: yes [&] 
: no 

: 61 sec 
: 50 
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Text files with long strings of blanks and binary files with repeated null characters turn 
out to be quite common. The average file—text or binary—is compressed about 15 per¬ 
cent during transmission using this simple method [18, pp. 248-250], which tends to off¬ 
set most other types of overhead introduced by the Kermit protocol. As an extreme ex¬ 
ample, we transfer a Sun SPARC executable program (“Hello World”), 24576 bytes in 
length: 

C-Kermit> set file type binary 
C-Kermit>s hello 


C-Kermit> statistics 
total file characters 
communication line out 
compression 
elapsed time 
transmission rate: 
effective data rate: 
efficiency (percent) 


24576 

3032 

yes [-] (23504) 
4 sec 
9600 bps 
6144 cps 
647 


File Attributes 


We are finished with Kermit protocol efficiency. Now let’s spend a few pages on your ef¬ 
ficiency, where we present features that let the sending Kermit tell the receiving Kermit 
certain facts about the file (so you don’t have to yourself), and that can prevent files from 
being transferred unnecessarily or in the wrong mode. 

The Kermit protocol has the ability to convey and process information about a file, called 
the file’s attributes, along with the file’s name and contents, if both Kermit programs sup¬ 
port this option and agree to use it. The attributes are sent in a special attribute packet 
(A-packet). Attribute information includes the file’s character set (see Chapter 9), the 
file’s creation date, length, type (text or binary), disposition, and an identifier for the send¬ 
ing system. Attribute packets are supported by (at least) C-Kermit, MS-DOS Kermit, 
Macintosh Kermit, and IBM Mainframe Kermit (see Table 1-1 on page 8). 

When the file arrives at the other Kermit, it introduces itself with a capsule biography: 
“Hi, my name is OOFA, I was bom in MS-DOS on January 9, 1986, at 10:28:00 AM, I 
am 12345 bytes long, I am made of ASCII text, and I would like you to print me,” or, 
translated into Attribute-packet language: 

A+!P1%12345I 111119860109 10:28:00."U8"#AMJ*1A 

Based on this information, the receiver can decide whether to accept or refuse the file, 
how to interpret it, and what to do with it. Here are the attributes supported by C-Kermit: 
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TYPE 

The sending Kermit tells the receiving Kermit whether the file is being sent in text (A) 
or binary (B) mode. This allows the receiving Kermit to switch between text and bi¬ 
nary modes automatically. UNIX and most other C-Kermit versions send the text or 
binary file type attribute according to your most recent set file type command. 

When receiving a file, the incoming file type attribute takes precedence over whatever 
you have set. For VMS and Open VMS, see Appendix IV. 

DATE 

When sending a file, C-Kermit includes its creation or last modification date and time 
(given in local time) in the attribute packet. When receiving a file whose creation date 
and time is given in the Attribute packet, C-Kermit stores the file with the given crea¬ 
tion date and time (or refuses to accept it if file collision is set to update and the 
arriving file is not newer than an existing file of the same name). Time zone informa¬ 
tion is not conveyed. 

LENGTH 

When sending a file, C-Kermit includes its length in the attribute packet. If the receiv¬ 
ing computer notices that the file is bigger than its available disk space or the user’s 
disk quota, it may refuse the file, which can save you a lot of wasted time and phone 
charges. When there is sufficient disk space, this information allows the receiving 
Kermit (if it is in local mode) to continuously display the percent done while the file is 
being transferred. When receiving a file, the OS/2, VMS, Commodore Amiga, and 
Atari ST versions of C-Kermit reject a file that is too large to fit in the available disk 
space (in VMS, the user’s quota is not checked). The UNIX, AOS/VS, and OS-9 ver¬ 
sions of C-Kermit currently do not check the reported file size against available disk 
space, and always accept the file. 

CHARACTER-SET 

This is the TRANSFER CHARACTER-SET (explained in Chapter 9). When sending a file 
in text mode and when the TRANSFER CHARACTER-SET is not TRANSPARENT (which 
is the default), C-Kermit translates from the current file character-set to the 
transfer character-set and includes a code to identify the transfer character- 
set in the Attribute packet. Codes contain registration numbers from the ISO Register 
[42], They include: 

16/100 ISO 8859-1 Latin Alphabet 1 
16/101 ISO 8859-2 Latin Alphabet 2 

16/144 ISO 8859-5 Latin/Cyrillic Alphabet 

114/13/87 Japanese EUC 

When receiving a text file, C-Kermit learns the TRANSFER CHARACTER-SET from the 
Attribute packet and translates from it into the current FILE CHARACTER-SET. 
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DISPOSITION 

What to do with the file. Normally, transferred files are simply stored on disk. This 
attribute is used by the MAIL and REMOTE print commands, presented in Chapter 7, to 
request that a file be sent as electronic mail or that it be printed, rather than stored on 
disk. 

SYSTEM-ID 

The file sender includes a code identifying its computer and operating system, in case 
the file receiver wants to use this information in any way. C-Kermit sends this item 
when sending files and ignores it when receiving files. System IDs are listed in [18, 
pp. 275-278]. 

If the other Kermit does not support the exchange of attribute packets, C-Kermit does not 
send them. This is settled automatically when the two Kermits first say hello to each other 
with the S or I packet. 

But when the two Kermits agree to exchange attribute information, you might find that the 
effects are not what you desire. For example, you might not want arriving files stored 
with their original dates because this causes your backup system to skip over them. Or 
you may find that Kermit’s estimate of available disk space is too conservative and it 
refuses a file that you believe will fit. So C-Kermit gives you the ability to turn each at¬ 
tribute on or off: 

SET ATTRIBUTE { CHARACTER-SET, DATE, DISPOSITION, LENGTH, 
SYSTEM-ID, TYPE } { ON, OFF } 

Turns a particular attribute on or off, leaving the others undisturbed. The individual 
settings are used only if the entire attribute mechanism is on. 

And if the attribute mechanism itself—as opposed to one or more particular attributes—is 
causing problems, you can disable and enable it with this command: 

SET ATTRIBUTE { ON, OFF } 

Turns the entire attribute mechanism on or off. When it is off, C-Kermit will not en¬ 
gage in attribute packet exchange with the other Kermit. 

You can also use SET ATTRIBUTE ALL ON or OFF to turn all individual attributes on or off at 
once without affecting whether the attribute mechanism itself is enabled or disabled. For 
example, to turn off all attributes except type, you could: 

C-Kermit> set attr all off (Turn 'em all off) 

C-Kermit> set attr type on (Turn this one back on) 

The SHOW ATTRIBUTES command displays C-Kermit’s current attribute-related settings. 
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Displaying and Controlling File Transfer Options 


Use the show protocol command to list C-Kermit’s current file transfer protocol-related 
settings: 


C-Kermit> show protocol 


Protocol Parameters: 

Send 

Receive 



Timeout: 

10 

7 

Server Timeout: 

0 

Padding: 

0 

0 

Block Check: 

3 

Pad Character: 

0 

0 

Delay: 

4 

Packet Start: 

1 

1 

Max Retries: 

10 

Packet End: 

13 

13 

8th-bit Prefix: 

'S.' 

Packet Length: 

90 

1000 

Repeat Prefix: 

/ / 

Maximum Length: 

9024 

9024 

Window Size: 

2 set, 1 used 

Buffer Size: 

9065 

9065 

Locking-Shift: 

enabled, used 


C-Kermit> 


Some of the protocol options are controlled by the file sender, others by the receiver, 
others can be elected by either one, still others require both to agree. There are some prin¬ 
ciples at work here, but they are not worth explaining. Instead, to reduce the confusion, 
Table 8-1 summarizes the major protocol options, who controls them, and with what com¬ 
mands. The File Type and Transfer Character-Set entries assume that the Attribute-Packet 
mechanism is active. If it isn’t, the appropriate SET commands must be given to both Ker- 
mits, rather than only to the file sender. 


Table 8-1 Kermit File Transfer Feature Summary 


Feature 

Controlled By 

Command 

File Collision 

Receiver 

SET FILE COLLISION to receiving Kermit 

File Type 

Sender 

SET FILE TYPE to sending Kermit 

File Character-Set 

Both 

SET FILE CHARACTER-SET to both KermitS 

Incomplete Transfers 

Receiver 

SET FILE INCOMPLETE to receiver 

Transfer Character-Set 

Sender 

set xfer character-set to sending Kermit 

Block Check 

Sender 

set block-check to sending Kermit 

8th-Bit Prefixing 

Either 

SET PARITY to either Kermit 

Locking Shifts 

Either 

SET PARITY to either Kermit 

Packet Length 

Receiver 

set receive packet-length to receiving Kermit 

Sliding Windows 

Both 

SET WINDOW to both Kermits 

Compression 

Automatic 

(none) 

Attributes 

Automatic 

SET ATTRIBUTE_OFF to disable 
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Chapter 9 


International Character Sets 


oooo 

If you have no need to transfer text files that contain accented or non-Roman 
characters and you never need to display these characters on your screen at 
C-Kermit command level or during CONNECT mode, skip ahead to Chapter 10 
on page 199. 

All the different computers and operating systems supported by C-Kermit use the ASCII 
character set, the American Standard Code for Information Interchange [1], listed in Table 
VIII-1 on page 461. 25 Command and file names, messages and help text—all textual mat¬ 
ter is encoded in ASCII. 

ASCII contains uppercase and lowercase Roman letters, decimal digits, and punctuation 
marks sufficient for representing English text and most computer commands and program¬ 
ming languages. But it does not contain the accented or special letters needed for Italian, 
Norwegian, French, German, or other languages written using Roman-based alphabets, let 
alone the non-Roman characters of languages like Russian or Japanese. 

Although C-Kermit’s user interface is strictly English and ASCII, you can use C-Kermit 
to conduct terminal sessions using a wide variety of Roman and non-Roman character sets 
and to transfer text files written in languages using most Roman, as well as Cyrillic and 
Japanese, character sets. This chapter tells you how. 


25 ASCH is the United States version of ISO 646 [36]. 
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Table 9-1 Decimal Character Codes for Accented Capital Letter A 


Character 


IBM PC 
CP 850 

Macintosh 

Quickdraw 

Data General 
DGI 

DECstation 
DEC MCS 

NeXT 

Workstation 

A-Grave 

A 

183 

231 

193 

192 

129 

A-Acute 

A 

181 

203 

192 

193 

130 

A-Circumflex 

A 

182 

229 

194 

194 

131 

A-Tilde 

A 

199 

204 

196 

195 

132 

A-Diaeresis 

A 

142 

128 

195 

196 

133 

A-Ring 

A 

143 

129 

197 

197 

134 


Proprietary Character Sets 

There are hundreds of different languages in the world, hundreds of different kinds of 
computers, and a potentially vast number of ways to represent the characters of each lan¬ 
guage on each computer. If we consider only the written languages based on the Roman 
alphabet, such as Italian, Portuguese, or Norwegian, we find that different computers, such 
as the IBM PC, the Apple Macintosh, the Data General MV system, the DECstation, and 
the NeXT workstation represent the accented letters and other special symbols in com¬ 
pletely different ways internally. Table 9-1 shows the codes for the uppercase letter A 
with various accents used by each of these computers. 

CP850 is IBM’s ASCII-based multilingual code page for PCs, Quickdraw is the character 
set most commonly used on Apple Macintosh computers, DGI is the Data General Inter¬ 
national character set, DEC MCS is DEC’S Multinational Character Set, and the NeXT 
character set is used on NeXT computers (see Table VIII-4 on page 464 for a fuller list¬ 
ing). These are just a few of the many proprietary character sets in current use. 

Most modem equipment supports some form of national or international text. As long as 
you stick with a particular manufacturer’s equipment—display, keyboard, printer—you 
can create, read, and print text in any language supported by your equipment. This is a 
great leap forward from the ASCII-only days. But what if you need to access a different 
kind of equipment from within your own computing environment? What if you need to 
exchange text with users of a different kind of equipment? 

There are several ways to cope with this problem. The traditional solution has been to ban 
the use of accented Roman letters as well as all letters from languages like Russian or 
Hebrew that have non-Roman alphabets. Since computers everywhere support the letters 
A-Z, transportability of data is assured. But the nature of the data is severely limited, and 
non-English speaking computer users justifiably resent this approach. 
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At the other extreme, we could attempt to translate directly between each character set and 
all the others. This works adequately when the number of sets is small, but quickly be¬ 
comes unwieldy and unmanageable as the number increases. If the number of character 
sets is n, the number of translations is n x (n- 1) (the number of pairs chosen from a set of 
size n, sampling without replacement; see any statistics book [54]). 

So if we have two character sets, A and B, we need two translations, one from A to B and 
one from B to A. If we have three sets—A, B, and C—we need 3x2 = 6 translations: 
AB, BA, AC, CA, BC, and CB. And so on. Each translation is typically a pair of tables, 
256 bytes in each. 

Now consider that IBM alone lists 276 different coded character set identifiers in its 
registry [35], If we needed translations between every pair of IBM character sets, we 
would require 75,900 of them, or about 4 megabytes of tables. Now add in all the other 
companies and their character sets to appreciate the magnitude of the problem. 

A more reasonable approach is to represent characters in a standard intermediate character 
set during transmission. The sender translates from its local codes to the standard ones, 
the receiver translates from the standard codes to its local ones. This cuts the problem 
down to a manageable size; each computer needs to know only its own character sets plus 
a handful of standard sets. 

Standard Character Sets 


Standard character sets come in 7-bit and 8-bit single-byte varieties, as well as multibyte 
sets for Chinese, Japanese, and Korean. 

The 7-bit sets include US ASCII and other national sets provided for by ISO Standard 
646 [36]. The more flexible 8-bit international standard character sets include ISO 8859 
Latin Alphabets 1 and 2 for Western and Eastern European languages, respectively, and 
the ISO 8859-5 Latin/Cyrillic 26 Alphabet [39]. Multibyte character sets include the 
Chinese, Japanese, and Korean national standard sets. 

ISO 646 is the international standard for 7-bit character sets. It is identical to ASCII ex¬ 
cept that 12 of its positions are set aside for the characters needed for each national lan¬ 
guage. In ASCII itself, the US version of ISO 646, these 12 positions are occupied by the 
familiar brackets, braces, bars, and so on, used in many programming languages. In other 
ISO 646 national versions, these character positions are occupied by national characters. 


26 “Cyrillic” refers to the family of alphabets used for Russian, Ukrainian, and other Slavic languages, 
created by Saint Cyril in the 9th century A.D. 
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Table 9-2 ISO 646 National Character Sets, Differences from ASCII 



2/03 

4/00 

5/11 

5/12 

5/13 

5/14 

5/15 

6/00 

7/11 

7/12 

7/13 

7/14 

decimal 

35 

64 

91 

92 

93 

94 

95 

96 

123 

124 

125 

126 

US ASCII 

# 

@ 

[ 

\ 

1 


_ 

/ 

{ 

1 

} 

~ 

British 

£ 

@ 

[ 

\ 

1 

- 

_ 

< 

{ 

1 

1 

~ 

Canadian-French 

# 

h 

a 

9 

e 

i 

_ 

6 

e 

u 

b 

u 

Chinese Roman 

# 

@ 

i 

¥ 

i 

- 

_ 

- 

i 

1 

} 

- 

Danish 

# 

@ 

JE 

0 

A 

- 

_ 

t 

ae 

0 

a 

~ 

Dutch 

£ 

X 

y 

'4 

i 

- 

_ 

/ 

•• 

/ 

X 

’ 

Finnish 

# 

@ 

A 

6 

A 

u 

_ 

6 

a 

6 

a 

ii 

French 

£ 

a 

O 

9 

§ 

- 

_ 

P 

6 

u 

b 

•• 

German 

# 

§ 

A 

O 

ii 

* 

_ 

l 

a 

6 

Ii 

B 

Hungarian 

# 

A 

£ 

0 

u 

- 


u 

6 

6 

ii 

t r 

Icelandic 

# 

i> 

D 

\ 

JE 

0 


b 

6 

i 

X 

6 

Italian 

£ 

§ 

O 

9 

6 

- 

_ 

U 

h 

6 

b 

i 

Japanese Roman 

# 

@ 

[ 

¥ 

] 

- 

_ 

/ 

1 

1 

) 

- 

Norwegian 

§ 

@ 

JE 

0 

A 

A 

— 

- 

as 

0 

a 

i 

Portuguese 

# 

t 

A 

c 

0 

A 

— 

- 

a 

9 

6 

~ 

Spanish 

£ 

§ 

i 

N 

6 


_ 

- 

O 

n 

9 

~ 

Swedish 

# 

E 

A 

0 

A 

u 

_ 

6 

a 

6 

a 

ii 

Swiss 

ii 


6 

9 

e 

i 

b 

6 

a 

6 

ii 

u 


For example, the character that occupies position 91, left bracket ([) in ASCII, is replaced 
by JE in Danish, y in Dutch, A in Finnish, I> in Icelandic, and so on, as shown in Table 9-2. 

The Latin alphabets are 8-bit, 256-character sets. As shown in Figure 9-1, the left half 
(first 128 characters) of each Latin alphabet is the same as ASCII. It includes 32 7-bit 
control characters (CO), the Space (SP) character, 94 7-bit graphic characters (GL), and 
the additional control character, DEL. The right half contains 32 8-bit (Cl) control 
characters and 96 graphic characters (GR) for a particular group of languages. Table 9-3 
lists the Latin alphabets. 

Table 9-4 on p. 174 shows the graphic characters (columns 10-15) of the right half of 
Latin Alphabet 1. The DEC Multinational Character Set is very similar to Latin-1, as you 
can see by comparing Tables 9-4 and 9-5. 
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00 

NUL 

DLE 

SP 

0 

@ 

P 

- 

p 




01 

SOH 

DC1 

J 

1 

A 

Q 

a 

q 




02 

STX 

DC2 

" 

2 

B 
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Figure 9-1 Structure of an 8-Bit Latin Alphabet 


Table 9-3 The ISO Latin Alphabets 


Character Set 

Standard 

Languages 

Latin-1 

ISO 8859-1 

Danish, Dutch, English, Faeroese, Finnisn, French, German, 
Icelandic, Irish, Italian, Norwegian, Portuguese, Spanish, 
Swedish 

Latin-2 

ISO 8859-2 

Albanian, Czech, English, German, Hungarian, Polish, 
Romanian, Serbocroatian (Croatian), Slovak, Slovene 

Latin-3 

ISO 8859-3 

Afrikaans, Catalan, English, Esperanto, French, Galician, Ger¬ 
man, Italian, Maltese, and Turkish 

Latin-4 

ISO 8859-4 

Danish, English, Estonian, Finnish, German, Greenlandic, 
Lappish, Latvian, Lithuanian, Norwegian, and Swedish 

Latin/Cyrillic 

ISO 8859-5 

Bulgarian, Bielorussian, English, Macedonian, Russian, Ser¬ 
bocroatian (Serbian), and Ukrainian 

Latin/Arabic 

ISO 8859-6 

Arabic, English 

Latin/Greek 

ISO 8859-7 

Greek, English 

Latin/Hebrew 

ISO 8859-8 

Hebrew, English 

Latin-5 

ISO 8859-9 

Dutch, English, Faeroese, Finnish, French, German, Irish, 

Italian, Norwegian, Portuguese, Spanish, Swedish, Turkish 
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Table 9-4 Right Half of Latin Alphabet 1 


Table 9-5 DEC Multinational Character Set 
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International Characters in Commands 


If you have an 8-bit communication link (no parity) between your terminal (keyboard and 
screen) and C-Kermit, or if you are running C-Kermit on a workstation, use the following 
command to tell C-Kermit to allow 8-bit characters in your commands: 

SET COMMAND BYTESIZE {!,%} 

Specifies the character size, in bits, to be used in C-Kermit’s commands and messages. 
The default is 7, allowing only 7-bit character sets. 

For example, suppose you have a German keyboard and an 8-bit connection to C-Kermit. 
SET COMMAND BYTESIZE 8 lets you use German letters in your commands. Correct display 
of 8-bit characters depends, of course, on your terminal emulator or console driver. 

C-Kermit> set command bytesize 8 
C-Kermit> echo qrtiBe aus Kolnl 
gruBe aus Kolnl 
C-Kermit> 
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International Characters in Terminal Emulation 


Most versions of C-Kermit provide no particular kind of terminal emulation during 
CONNECT mode. Kermit just passes all characters received from the remote host along to 
your screen and passes your keystrokes to the remote host. The responsibility for most 
terminal-oriented functions—escape sequence interpretation, function keys, screen roll¬ 
back, and so on—lies in your terminal, emulator, or workstation window. 

Character-set translation is an exception to this rule. If the remote computer or service 
uses a character set different from your local computer and it is known to C-Kermit, you 
can ask C-Kermit to translate between the remote character set and the one used by your 
terminal or emulator so the characters sent by the remote computer will have the correct 
appearance on your screen and the characters you type will be translated into the remote 
computer’s character set before being sent. 


Choosing the Terminal Character Set 

C-Kermit usually has no way of knowing which character sets are in use. You must tell it 
by giving the following command: 

SET TERMINAL CHARACTER-SET remote-cset [ local-cset ] 

Specifies the character set used on the remote computer ( remote-cset ) and the charac¬ 
ter set used by your terminal or emulator ( local-cset ). If local-cset is not specified, 
C-Kermit’s current FILE CHARACTER-SET (explained on page 182) is used. To disable 
terminal character-set translation, use SET TERMINAL CHARACTER-SET TRANSPARENT, 
which is the default. 


To find out which character sets are available, type a question mark in either one of the 
character-set name fields: 


C-Kermit>set terminal character-set ? 


remote terminal character-set, c 
ascii british 

cp850 cp852 

danish dec-multinational 

finnish french 

italian koi8-cyrillic 

macintosh-latin next-multinational 
short-koi Spanish 

transparent 

C-Kermit>set terminal character-set 
C-Kermit> 


of the following: 
canadian-french 
cp866-cyrillic 
dg-international 
german 
latinl-iso 
norwegian 
Swedish 

Spanish 


cp437 

cyrillic-iso 

dutch 

hungarian 

latin2-iso 

Portuguese 

swiss 


Table 9-7 on page 181 tells you exactly which character sets these names refer to. The 
sets with “national” names, like French, Dutch, Finnish, and so on, are 7-bit ISO 646 na¬ 
tional sets, which are shown in Table 9-2 on page 172. The Roman 8-bit sets (Latin-1, 
DEC Multinational, NeXT, etc.) are shown in Tables VIII-4 and VIII-5, and the Cyrillic 
codes are listed in Table VIII-6. These tables begin on page 464. 
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Here is an example in which we CONNECT from C-Kermit on a PC running SCO UNIX 
and using IBM Code Page 437 to a remote Mailbox (BBS) in Cologne, Germany, that 
uses the German ISO 646 set. 

C-Kermit>connect 
Gr}~e aus K|ln! 

F}r Mailbox "gast" eingeben... 
login: 

If this does not look like German to you, it’s because the remote computer is using a dif¬ 
ferent character set than your local one. Let’s try it again, but this time with C-Kennit 
providing the translation: 

C-Kermit >set terminal char german cp437 

C-Kermit >connect 

GriiBe aus Koln! 

Fur Mailbox "gast" eingeben... 
login: 

When terminal character-set translation is in effect, C-Kermit uses a standard character set 
(such as Latin-1), if necessary, as an intermediate step between the local and remote sets. 
Otherwise, C-Kermit’s 28 terminal character sets would require 756 translation functions! 
But by choosing an appropriate intermediate set for each pair, we have about 100, and 
these also happen to be the same ones we use for file transfer. However, as a result of this 
ecologically sound design, we can lose characters that the local and remote character sets 
do not have in common with the intermediate set. For example, both the Macintosh and 
NeXT character sets have a Florin sign (/), but since Latin-1 doesn’t have one (see Table 
VIII-4), it is replaced by something else along the way, most likely a question mark. 

Using a 7-Bit Terminal Character Set 

If both the remote and local terminal character sets are 7-bit sets (ASCII, Short KOI, or 
one of the ISO 646 national sets like Italian, Portuguese, or Norwegian), you should be 
able to operate in both the 7-bit and 8-bit communication environments equally well. 

However, a word of warning is required. If the remote computer sends escape sequences 
to control the appearance of your screen, these sequences might contain 7-bit graphic 
characters that would normally be translated before they reach your screen. For example, 
many ANSI and therefore VT100, VT200, and VT300 escape sequences [4, 53] include 
the left bracket ([) character, as in: 27 
ESC [ 24 ; 40 H 


27 esc is the ASCn Escape character. Spaces are shown for clarity, but are not part of the escape 
sequence. 


176 International Character Sets / Chapter 9 



Table 9-6 ANSI Escape Sequence Formats 


Introducer 

Type 

Terminator 

ESC [ 

Control Sequence 

64-126 

ESC P 

Device Control String 

ESC \ 

ESC ] 

Operating System Command 

ESC \ 

ESC A 

Privacy Message 

ESC \ 

ESC 

Application Program Command 

ESC \ 

ESC other 

Escape Sequence 

48-126 


which moves the cursor to column 40 of line 24 on the screen. But the left bracket is an 
ISO 646 national character and would be translated as shown in Table 9-2 on page 172, 
thus destroying the escape sequence and interfering with your screen display. 

C-Kermit does its best to avoid this effect by skipping translation of ANSI escape se¬ 
quences during connect mode. ANSI escape sequences begin with the ESC (Escape) 
character, ASCII 27, and terminate under various conditions, depending on the character 
that follows the Escape, as shown in Table 9-6. Whenever C-Kermit sees an Escape 
character under these conditions, it reads the ensuing characters up to and including the 
final character or sequence, listed in the Terminator column in the table, and sends them 
to the screen without translation. In the example: 

ESC [ 24 ; 40 H 

ESC [ is a Control Sequence Introducer, which means that the escape sequence continues 
until a terminating character in the range 64-126 appears. The first such character in the 
example is H. 

This technique is used only when translation of a 7-bit character set is requested, and so 
8-bit escape sequences are not, and don’t need to be, recognized. C-Kermit makes no at¬ 
tempt to handle non-ANSI terminal control codes. 

Using an 8-Bit Terminal Character Set 

During C-Kermit CONNECT mode, there are two components to the connection between 
your desktop terminal or computer and the remote computer or service: the one between 
C-Kermit and your keyboard and screen, and the one between C-Kermit and the remote 
host or service. Each component can be either a 7-bit or an 8-bit connection. Unless you 
tell C-Kermit otherwise, it treats both as 7-bit connections. This is to prevent parity from 
being mistaken for real data, a sensible default given the widespread use of parity and the 
equally widespread lack of awareness about it. But this default prevents the use of 8-bit 
character sets during a connect session. 


International Characters in Terminal Emulation 177 



Screen 


GruSe 
aus 
Kol n! 


Connection 
between C-Kermit 
and your keyboard 
and screen 



SET COMMAND 
BYTESIZE {7,8} 



Keyboard 


Computer 


C-Kermit 

Translation 


Figure 9-2 Terminal Character Set Translation 
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Figure 9-2 shows the two components of the CONNECT-mode connection. If the communi¬ 
cation path between your terminal or emulator and C-Kermit (A in the figure) is truly 
8-bits-no-parity, you can give the command set command bytesize 8 to tell C-Kermit 
not to strip the 8th bit from each character that comes in from your keyboard and goes out 
to your screen. 

Similarly, if the path between C-Kermit and the remote host (B in the figure) is really 8 
bits, give the commands SET TERMINAL BYTESIZE 8 and (if necessary) SET PARITY NONE to 
prevent Kermit from stripping the 8th bit of characters that go in to and out of the com¬ 
munication device. Now you can use 8-bit terminal character sets with no further ado. 

Using an 8-Bit Terminal Character Set on a 7-Bit Connection 

If the connection between C-Kermit and the remote host (B) is normally 7 bits, but you 
need to transmit and receive 8-bit characters, you might still be able to do so. Explore the 
terminal- and communication-related commands of the remote host and of any communi¬ 
cation equipment or networks in between: SET TERMINAL /EIGHT on VMS or Open VMS, 
stty pass8 or stty -parity on some UNIX systems, rsh -8 host when making 
“rshell” connections from one UNIX system to another; check the configuration of your 
modem, terminal server, network PAD, and so on. Do whatever you can to achieve an 
8-bit connection. 

If all else fails, the C-Kermit CONNECT command supports a terminal-oriented protocol, 
known as shift-in/shift-out, that allows it to exchange 8-bit data over a 7-bit terminal con¬ 
nection. The remote host must also be using this protocol. It works like this: if an 8-bit 
character (a character with its 8th bit set to 1) must be sent on a 7-bit connection, an SO 
character (Shift Out, Control-N, ASCII 14) is sent first, then the 8-bit character is sent 
with its 8th bit replaced by the required parity bit. When the receiver gets the SO, it 
knows to set the 8th bit of subsequently received characters to 1 before interpreting them. 
The next time a 7-bit character must be sent, an SI character (Shift-In, Control-O, ASCII 
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character 15) is sent first. This tells the receiver to set the 8th bit of subsequently received 
characters to 0. Thus, SO applies to all subsequent characters until an SI is received, and 
vice versa. To illustrate, suppose we have the German phrase: 

GruBe aus Kolnl 

encoded in Latin Alphabet 1. Using SO/SI, it would be transmitted like this: 

Gr<SO>|_<SI>e aus K<SO>v<SI>lnl 

where <so> and <si> represent the Shift-Out and Shift-In control characters. The 
“funny” characters are obtained by removing the 8th bit from the Latin-1 special charac¬ 
ters, which is equivalent to subtracting 128 from their code values. For example, the 
Latin-1 code for ii is 252, minus 128 is 124, which is the code for vertical bar, |. 

Here is the C-Kermit command that controls the use of Shift-In/Shift-Out during terminal 
connection: 

SET TERMINAL LOCKING-SHIFT { OFF, ON } 

This setting, which is normally off, applies to the portion of the connection between 
C-Kermit and the remote host. If you plan to use an 8-bit character set on the remote 
host, but you only have a 7-bit connection, and the remote host can use Shift-In and 
Shift-Out codes to switch between 7-bit and 8-bit characters, set this option to ON. 
When TERMINAL LOCKING-SHIFT is ON, C-Kermit interprets incoming characters ac¬ 
cording to the current shift state and automatically shifts the characters you type on 
your keyboard before sending them to the remote host. 

If the remote host uses an 8-bit character set, but you can’t get an 8-bit connection to it, 
and it does not support shift-in/shift-out, all is not necessarily lost. For example, on a 
remote UNIX host, you can pipe your 8-bit files through a shift-in/shift-out filter like the 
one in Appendix XI, for example: 

$ cat latinl.txt | so | more 

Key Mapping 

C-Kermit translates the keys you press into the remote host’s character set before trans¬ 
mitting them, according to your most recent SET TERMINAL CHARACTER-SET command. 
These translations also apply to any key redefinitions you have made with the SET KEY 
command. 

National or international characters in your key definitions should use the coding of your 
local character set, not the remote coding. This is the more natural arrangement and it al¬ 
lows you to access different remote computers that use different character sets without 
having to change your key mappings. 
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Transferring International Text Files 

The Kermit protocol distinguishes between vendor-specific codes, used in storing and dis¬ 
playing files on each computer, and the codes used within Kermit’s packets when transfer¬ 
ring a file [30], The vendor-specific file encoding is called the file character-set; the file 
character-sets known to C-Kermit are listed in Table 9-7. The code used during file trans¬ 
fer is called the transfer character-set. The Kermit protocol supports only a small number 
of transfer character-sets, namely those that are well-established as international standards, 
such as ISO 8859-1 Latin Alphabets 1 and 2 or ISO 8859-5 Latin/Cyrillic. 28 The sender 
translates the file from its local code to the standard transfer code, and the receiver trans¬ 
lates from the transfer code to its own local code, as shown in Figure 9-3. 

Specifying Character Sets for File Transfer 

If your computer supports international character sets at all, it probably does so only as an 
afterthought. Most computers and operating systems were designed to support only a 
single character code such as ASCII or EBCDIC, suitable only for representing English. 
As computer users in non-English-speaking countries began to demand support for their 
own languages, IBM, DEC, Apple, and other manufacturers introduced terminals, printers, 
and PCs capable of displaying French, German, Italian, Russian, Hebrew, Arabic, 
Japanese, and other languages, but in most cases they did this without significantly chang¬ 
ing the computers themselves. Text is still stored on the disk in undistinguished, 
anonymous 8-bit bytes, and the terminal or printer must be told how to interpret them. 
Files are stored on most computers without any indication of character set. 

To send or receive a file containing international characters, you must tell C-Kermit which 
character sets to use: which character set the original file is encoded in, which standard 


28 Eventually, there will be a single standard encoding that encompasses most of the world’s character 
sets [40], 
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Table 9-7 C-Kermit File Character Sets 


Name 

Bits 

Description 

ascii 

1 

ISO 646 United States Version, ASCII, ANSI X3.4-1986 [1] 

british 

7 

ISO 646, British Version, BSI4730 [7] 

canadian-french 

7 

French-Canadian NRC (DEC) [26] 

cp437 

8 

IBM Code Page 437, used on PCs [34] 

cp850 

8 

IBM/Microsoft Code Page 850, used on PCs [34] 

cp852 

8 

IBM/Microsoft Code Page 852 for Eastern Europe [34] 

cp866 

8 

Microsoft Code Page 866 Cyrillic, used on PCs [48] 

cyrillic-iso 

8 

ISO 8859-5 Latin/Cyrillic Alphabet [39] 

danish 

7 

(Same as Norwegian) [42] 

dec-multinational 

8 

DEC Multinational Character Set [26] 

dg-international 

8 

Data General International Character Set [23] 

dec-kanji 

M 

DEC multibyte Japanese Kanji 

dutch 

7 

Dutch NRC (DEC) [26] 

finnish 

7 

Finnish NRC (DEC) [26] 

french 

7 

ISO 646, French Version, NF Z 62010-1982 [42] 

german 

7 

ISO 646, German Version, DIN 66083 [42] 

hungarian 

7 

ISO 646, Hungarian Version, HS 7795/3 [42] 

italian 

7 

ISO 646, Italian Version [42] 

japanese-euc 

M 

Japanese Extended UNIX Code, JIS X 0201 + JIS X 0208 

jis7-kanji 

M 

Japanese 7-bit JIS Encoding 

koi8-cyrillic 

8 

“Old KOI-8” Cyrillic (GOST 19768-74) [50] 

latinl-iso 

8 

ISO 8859-1 Latin Alphabet 1 [39] 

latin2-iso 

8 

ISO 8859-2 Latin Alphabet 2 [39] 

macintosh-latin 

8 

Apple Quickdraw extended 

next-multinational 

8 

NeXT Workstation 

norwegian 

7 

ISO 646, Norwegian Version, NS 4551 [42] 

Portuguese 

7 

ISO 646, Portuguese Version [42] 

shift-jis-kanji 

M 

Code Page 932 Kanji, used on PCs 

short-koi 

7 

7-bit Roman and Cyrillic, uppercase only [50] 

Spanish 

7 

ISO 646, Spanish Version [42] 

Swedish 

7 

ISO 646, Swedish Version, SEN 850200 [42] 

swiss 

7 

Swiss NRC (DEC) [26] 
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character set is to be used during transfer, and which character set is to be used in the new 
copy of the file. The first command you need is: 

SET FILE CHARACTER-SET name 

Identifies the character set to be used for file input or output. The file sender translates 
from the file character set to the transfer character set, and the file receiver translates 
from the transfer character set to its own file character set. In most cases, the default 
file character-set is ASCII. In certain versions of C-Kermit, the local character set is 
known, so that is your default file character-set. For example, on the NeXT, it is the 
NeXT character set; on AOS/VS systems, it is DG-Intemational; in OS/2, it is your 
current PC code page. 

Your version of C-Kermit does not necessarily support all of the file character-sets listed 
in Table 9-7. C-Kermit can be configured to omit one or more character-set families: East 
European, Cyrillic, or Japanese Kanji. You can use the SHOW features and CHECK com¬ 
mands to obtain configuration information: 

C-Kermit> show features 

No Kanji character-set translation 
C-Kermit> check latin2 
Available 
C-Kermit> 


To see the list of supported file character-sets, use a question mark in the SET FILE 
CHARACTER-SET command: 


C-Kermit> set file char ? local file 
ascii british 

cp850 cp852 

danish dec-kanji 

dutch finnish 

hungarian italian 

koi8-cyrillic latinl-iso 

next-multinational norwegian 
short-koi Spanish 

C-Kermit>set file char hungarian 


code, one of the 
canadian-french 
cp866-cyrillic 
dec-multinational 
french 

japanese-euc 

latin2-iso 

Portuguese 

Swedish 


following: 

cp437 

cyrillic-iso 

dg-international 

german 

jis7-kanji 

macintosh-latin 

shift-jis-kanji 

swiss 


This is the list you would see with a fully-configured C-Kermit program. 


Choosing the appropriate file character-sets for the two computers solves two-thirds of the 
puzzle. To complete the puzzle, you must choose the transfer character-set that is best 
capable of representing the characters in your file character-sets: 

SET TRANSFER CHARACTER-SET name 

Identifies the intermediate character set to be used in Kermit-to-Kermit communica¬ 
tion, that is, in Kermit’s data packets. Synonym: SET XFER CHARACTER-SET. 

The default transfer character-set is TRANSPARENT, meaning that no translation takes place 
during file transfer. 
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C-Kermit supports the following transfer character-sets: 

LATIN1-ISO 

is ISO 8859-1 Latin Alphabet 1 [39], or Latin-1 for short. This is the usual choice 
for Western European languages based on the Roman alphabet, such as Italian, Por¬ 
tuguese, Norwegian, French, and Spanish, because it is capable of representing all the 
characters used in about 15 of these languages (see Table 9-3). Latin Alphabet 1 is 
listed in Table VIII-4. 

LATIN2-ISO 

is ISO 8859-2 Latin Alphabet 2, or Latin-2 for short. This is the usual choice 

for Eastern European languages based on the Roman alphabet, such as Czech, Polish, 

Romanian, and Hungarian (see Table 9-3). Latin Alphabet 2 is listed in Table VIII-5. 

CYRILLIC-ISO 

is ISO 8859-5, the Latin/Cyrillic Alphabet [39], also known as ECMA-113 [27], 
which can represent Russian, Ukrainian, and other languages written in Cyrillic and 
(because it includes ASCII as its left half) English. Listed in Table VIII-6. 

JAPANESE-EUC should be used for Japanese text. 

ASCII 

means to render each character as its closest ASCII equivalent, for example by remov¬ 
ing diacritical marks from accented Roman vowels, or by converting Cyrillic charac¬ 
ters “by sound.” Use this option when your computer does not have a way to display 
the file’s characters correctly (these conversions don’t work for Japanese). 

TRANSPARENT 

means that no character translation occurs; each code is sent as-is. For compatibility 
with earlier releases of C-Kermit, this is the default transfer character-set. This option 
can also be used whenever both computers use the same character set. 

Your version of C-Kermit might be configured differently. To find out which transfer 
character-sets are available to you: 

C-Kermit> set transfer char ? 
ascii latinl-iso transparent 

When you specify the file and transfer character-sets, Kermit picks the appropriate trans¬ 
lation function and uses it as shown in Figure 9-4 on the next page, which illustrates what 
happens when you transfer an Italian language text file from a PC with MS-DOS Kermit 
to a Data General Aviion workstation with C-Kermit. 

It’s your job to use the set file character-set and set transfer character-set com¬ 
mands to pick the translation you need. Kermit can’t do this for you because it doesn’t 
know what you are trying to accomplish. To illustrate this point, let’s suppose you want 
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Remote C-Kermit Commands 


Local PC Kermit Commands 
MS-Kermit> set file char cp437 C-Kermit> set file char dq 

MS-Kermit> set transfer char latinl C-Kerrni t> set xfer char 1 a tin1 

MS-Kermit> send linguini.txt C-Kermit> receive 


IBM PC DG Aviion 



to receive a French-language text file with C-Kermit on an SCO UNIX system running on 

an IBM or compatible PC. The TRANSFER CHARACTER-SET is LATIN l. Your PC uses 

Code Page 437. You can choose your FILE CHARACTER-SET to be: 

• CP437 if you want the file to display correctly on your PC screen 

• CP850 if you want to copy the file to a tape cartridge for an IBM RS/6000 

• LATIN 1 if you want to keep the Latin- 1 encoding intact for an application on your PC 
that requires Latin-1 rather than CP437 

• FRENCH if you want to print the file on your PC printer, but your printer only supports 
the French ISO 646 character set 

• ASCII if you want to convert the special characters to plain ASCII, for example be¬ 
cause your PC-based e-mail system only supports ASCII 

• NEXT if you want to copy the file to a DOS-format diskette to be read on a NeXT 
workstation 

And so on — 
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Use the show character-sets command to see C-Kermit’s current terminal, file, and 
transfer character-sets: 

C-Kermit> sho char 

File Character-Sets US ASCII (7-bit) 

Transfer Character-Sets Transparent 

Unknown-Char-Sets Keep 

Terminal character-sets transparent 


(Now change them...) 


C-Kermit>set 

file 

char 

next 

C-Kermit>set 

xfer 

char 

latinl 

C-Kermit>set 

term 

char 

dq next 

C-Kermit>set 

unkn 

discard 


C-Kermit> sho char 

File Character-Sets NeXT Multinational (8-bit) 

Transfer Character-Sets LATIN1, ISO 8859-1 
Unknown-Char-Sets Discard 
Terminal character-sets s 
Remotes dg-international 
Locals next-multinational 
Vias latinl-iso 

C-Kermit> 

The UNKNOWN-CHAR-SET setting tells C-Kermit what to do if a file arrives announcing it¬ 
self with a character set that C-Kermit doesn’t support. Normally the file is accepted 
(KEEP) without translation, but you can also instruct C-Kermit to reject such files: 

C-Kermit> sent unknown-char-set discard 

The SET UNKNOWN-CHAR-SET command is effective only when given to the file receiver. 

Transferring Roman Text 

Let’s try a simple example. Suppose we have a German-language file stored on an IBM 
PC using PC Code Page 437. The file is called modem. txt and it looks like this: 

Wer ein Selbstwahl-Modem hat, muJ3 zur Herstellung der Verbindung 
mit dem anderen Rechner die Wahlkommandos eintippen. Man kann zur 
Kermit-Kommandoebene zuriickgelangen durch Eintippen der 
'Ruckkehrsequenz' . 

Let’s transfer this file from the PC to a UNIX system that uses the 7-bit German character 
set. Assume we’re already logged in. The Kermit program on each computer must be 
told which file character-set to use, but only the file sender has to be told the transfer 
character-set because the sender automatically informs the receiver in the attribute packet. 
First tell MS-DOS Kermit on the PC which character sets to use: 

MS-Kermit> set file character-set cp437 
MS-Kermit>set transfer character-set latinl 
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Now go to the UNIX system, start C-Kermit, tell it which file character-set to use, and 
then tell it to wait for the file: 


MS-Kermit >connect 
$ kermit 

C-Kermit> set file character-set german 
C-Kermit >receive 

Now escape back to the PC and send the file. MS-DOS Kermit automatically tells 
C-Kermit that the transfer character-set is Latin-1. 


Alt-X (Escape back) 

MS-Kermit >send modem.txt (Send the file) 

(The file is transferred...) 

Now the file is stored on the UNIX system with German ISO 646 encoding. To check that 
it was transferred correctly, tell MS-DOS Kermit’s terminal emulator about the character 
set and then connect back to UNIX and display the file on your screen: 

MS-Kermit> set terminal character-set german 

MS-Kermit> connect 

C-Kermit> type modem.txt 

Wer ein Selbstwahl-Modem hat, mufi zur Herstellung der Verbindung 
mit dem anderen Rechner die Wahlkommandos eintippen. Man kann zur 
Kermit-Kommandoebene zuriickgelangen durch Eintippen der 
'Rtickkehrsequenz'. 

$ 


As you can see, the file arrived with its special characters intact. Now let’s transfer the 
same file from UNIX to another PC. But this time it is to be printed on a device that does 
not have German characters. Here we choose ASCII as the transfer character-set to trans¬ 
late the special characters to their closest ASCII equivalents, rather than into gibberish: 


C-Kermit >set file char german 
C-Kermit >set xfer char ascii 
C-Kermit >send modem.txt 
alt<X> 

MS-Kermit>receive 

(The file is transferred...) 
MS-Kermit> type modem.txt 


(Translate from this) 

(to this) 

(Send the file from UNIX) 
(Escape back) 

(Wait for the file on the PC) 
(Take a look...) 


Wer ein Selbstwahl-Modem hat, mus zur Herstellung der Verbindung 
mit dem anderen Rechner die Wahlkommandos eintippen. Man kann zur 
Kermit-Kommandoebene zuruckgelangen durch Eintippen der 
'Ruckkehrsequenz'. 

$ 


Notice how a has become simply a, ii has become u, and B has become s. Without these 
translations, the text would have been printed like this: 

Wer ein Selbstw{hl-Modem hat, mu- zur Herstellung der Verbindung 
mit dem anderen Rechner die W{hlkommandos eintippen. Man kann zur 
Kermit-Kommandoebene zur}ckgelangen durch Eintippen der 
'RJckkehrsequenz'. 
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Transferring Cyrillic Text 

Cyrillic text (Russian, Ukrainian, Bielorussian, and so on) can be encoded using a variety 

of different and incompatible character sets, including at least the following: 

• Microsoft Code Page 866 [48], used on PCs, which, like other PC code pages, has 
ASCII in the left half and the special characters in the right. Supported by MS-DOS 
Kermit and C-Kermit. 

• Alternative Cyrillic, a precursor to Code Page 866, developed for PCs in the Soviet 
Union by Bryabin, et al. [6]. 

• IBM Code Page 855 for PCs [34]. Like Code Page 866, but with different encoding. 

• Old KOI-8, an 8-bit Soviet government standard (GOST 19768-74) [50] character set 
consisting of full upper- and lowercase Latin and Cyrillic alphabets, in which the 8-bit 
Cyrillic letters run parallel to their 7-bit ASCII phonetic equivalents. KOI stands for 
Ko,q A/m OSMeHa MHc}DopMaTCMH —Kod dlia Obmiena Informatsii (Code for In¬ 
formation Interchange, like the CII in ASCII). 

• New KOI-8, a newer standard (GOST 19768-87) that is supposed to replace Old 
KOI-8. Old KOI-8 is still in wide use. 

• Short KOI [50], a 7-bit code containing the uppercase Roman and Cyrillic letters, but 
no lowercase. The Roman letters are in ASCII order, and Cyrillic letters parallel the 
Roman letters phonetically. 

• DKOI [50], similar to KOI-8, but with an EBCDIC-style layout, used on IBM com¬ 
patible mainframes and supported by IBM mainframe Kermit [16]. 

• IBM Code Page 880 [34], IBM’s EBCDIC-based Cyrillic Multilingual Code Page 
for IBM mainframes, totally different from DKOI, supported by IBM mainframe 
Kermit [16]. 

• IBM Code Page 1025, a newer revision of IBM Code Page 880. 

• ISO 8859-5 Latin/Cyrillic, similar to Latin-1, but with Cyrillic characters in the right 
half. This is the international standard Cyrillic character set. 

Each of these sets is capable of representing both Roman and Cyrillic letters. The Kermit 

protocol uses ISO 8859-5 Latin/Cyrillic as the transfer character-set for Cyrillic text, sup¬ 
ported, as of this writing, by MS-DOS Kermit, IBM mainframe Kermit, and C-Kermit. 

Use this command: 

SET TRANSFER CHARACTER-SET CYRILLIC 

to select the Latin/Cyrillic transfer character-set. 
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C-Kermit supports the following Cyrillic file character-sets: 

SET FILE CHARACTER-SET CYRILLIC 

ISO 8859-5 Latin/Cyrillic. 

SET FILE CHARACTER-SET CP866 
Microsoft PC Code Page 866. 

SET FILE CHARACTER-SET KOI8 
Old KOI-8. 

SET FILE CHARACTER-SET SHORT-KOI 
Short KOI. 

These character sets are listed in Table VIII-6 on page 470. The method for transferring 
Cyrillic files is the same as for Roman text. You have to identify the file character-set to 
be used on each computer and you also must tell the file sender which transfer 
character-set to use. Here is an example in which we send a KOI-8 file from C-Kermit to 
an IBM-compatible mainframe, where it is to be stored using EBCDIC CECP 880: 

Kermit-CMS >set file char cp880 (Translate to IBM code page) 
Kermit-CMS> receive (Receive the file) 

Ctrl-\c (Escape back to C-Kermit) 

C-Kermit> set file char koi8 (Identify the file character-set) 

C-Kermit >set xfer char cyrillic (Translate to Latin/Cyrillic) 
C-Kermit> send icsti.txt (Send the file) 

C-Kermit tells IBM Mainframe Kermit that the transfer character-set is Latin/Cyrillic, and 
IBM Mainframe Kermit translates from this to Code Page 880. 

Suppose you need to look at Cyrillic text on a computer that does not have a Cyrillic dis¬ 
play device available. Use Short KOI, in which all Roman letters are converted to upper¬ 
case, and Cyrillic letters are converted to their lowercase Roman phonetic equivalents, 
listed in Table VIII-6 on page 470. In this example, we send a copy of Pushkin’s poem 
Bronze Horseman from a PC, where it is stored using CP866, to C-Kermit, where it is 
stored in Short KOI format. 

MS-Kermit> type horseman.txt (Read it in Russian) 

Ha 6epery nycTbiHHbix bojih 
Ctohji oh, nyM BennKHX no/iH, 

\A BAa/ib r/iflfle/i. llpeA hum liinpoxo 
Peica Hecnacn; 6eflHbifi senH 
no Heii CTpeMHncn oahhoko. 

MS-Kermit> connect 
C-Kermit> set file char short-koi 
C-Kermit> receive 
Alt-X 


(Go to UNIX) 

(Translate to Short KOI) 
(Wait for the file) 
(Escape back) 
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MS-Kermit> set file char cp866 
MS-Kermit> set transf char cyr 
MS-Kermit> send horseman.txt 

(The file is transferred...) 

MS-Kermit> connect 
C-Kermit> type horseman.txt 

na beregu pustynnyh woln 
stoql on, dum welikih poln, 
i wdalx glqdel. pred nim {iroko 
reka neslasq; bednyj -eln 
po nej stremilsq odinoko. 


(Translate from this...) 
(to this) 

(Send the file) 


(Go back to UNIX) 
(Look at the result) 


You can mix Roman-based and Cyrillic-based character sets during file transfer, but then 

you lose the Cyrillic characters. For example, if you translate from KOI-8 to Latin-1, the 

ASCII text survives, but the Cyrillic characters all become question marks (but see page 

193 before giving up on this idea). 

Similarly, if you translate from Latin-1 to Latin/Cyrillic, it is the same as translating from 

Latin-1 to ASCII. All accents and other diacritical marks are lost. 

Transferring Japanese Text 

Japanese writing combines several different elements: 

• Kanji, ideograms similar to those used in China and Korea, with each ideogram stand¬ 
ing for a word. More than 6,000 Kanji symbols are in common use. 

• Kana, a phonetic writing system, containing 50-60 characters, including punctuation 
and sound symbols. Kana comes in two major varieties, Katakana and Hiragana, the 
latter being a more cursive and stylized form. 

• Roman letters, digits, and punctuation. 

As you might expect, there is more than one character set for representing Japanese text: 

• JIS (Japan Industrial Standard) X 0201 [43] combines Roman and Katakana in a 
Latin-alphabet-like 8-bit single-byte character set. It differs from a Latin alphabet in 
that the left half is not exactly ASCII (backslash is replaced by Yen sign, tilde by over¬ 
bar), and the right half has some empty positions. 

• JIS X 0208 [44] is a set of 6877 two-byte characters including Roman, Cyrillic, Greek, 
Katakana, Hiragana, and Kanji characters, plus special symbol and line-drawing 
characters. 

• JIS X 0212 [45] is a newer revision of JIS X 0208. 


Transferring International Text Files 189 



• Japanese EUC (Extended UNIX Code) combines JIS X 0201 and 0208 in a single 
code in which single-byte Roman characters have their 8th bits set to zero, 
double-byte JIS X 0208 codes have their 8th bits set to 1, and single-byte JIS X 0201 
Katakana codes are invoked via a single-shift mechanism. 

• Shift-JIS (Code Page 932) is used on PCs and includes single-byte Roman and 
Katakana and 2-byte Kanji, but at different code points than the standard sets or EUC. 

• DEC Kanji is used on VMS and Open VMS and is equivalent to EUC, but without 
single-byte Katakana. 

• Various “EBCDIC” Kanji codes are used on IBM, Hitachi, and Fujitsu mainframes, 
supported by IBM mainframe Kermit [16]. 

To complicate matters, we have 7-bit transmission media and e-mail to contend with. For 
this, a variation of EUC called JIS-7 is used, in which all characters are represented by 
7-bit bytes, and switching among JIS Roman, JIS Katakana, and JIS X 0208 is done by 
locking shifts [30, 37] imbedded in the data stream. 

C-Kermit uses Japanese-EUC as the transfer character-set for Japanese text, since it ac¬ 
commodates the three major writing methods and still distinguishes between single- and 
double-width Roman and Katakana characters: 

SET TRANSFER CHARACTER-SET JAPANESE-EUC 

C-Kermit supports the following Japanese file character-sets: 

SHIFT-JIS 

Shift-JIS (CP932) on PCs. 

DEC-KANJI 

DEC Kanji, used primarily on VMS and OpenVMS. 

JIS-7 

The code most commonly used in electronic mail. 

JAPANESE-EUC 

Japanese Extended UNIX code itself, commonly found on UNIX computers. 

Here we use C-Kermit on a PC-based UNIX system (which uses Shift-JIS) to send a Kanji 
file to C-Kermit on a remote VAX (which uses DEC-Kanji). We also use the SET prompt 
command to distinguish between the two C-Kermit prompts. 

C-Kermit> set prompt Kyoto> (Local PC Kermit prompt) 

Kyoto> set file char shift-jis (Translate from this...) 

Kyoto >set xfer char japan (to this) 

Kyoto> connect (Go to the VAX) 
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$ kermit (Start Kermit) 

C-Kermit> set prompt Tokyo> (Change the prompt) 

Tokyo >set file char dec-kanji (Translate to this) 
Tokyo>r (Receive the file) 

Ctrl-\c (Escape back) 

Kyoto> send qenji.txt (Send the file) 


There is no mechanism for translating Japanese into Roman characters or vice versa. 
C-Kermit lets you combine Japanese and non-Japanese transfer and file character-sets, but 
only the Roman letters are preserved. C-Kermit does not support Japanese character set 
translation during terminal emulation. 


Language-Specific Translations 

When C-Kermit is receiving a file encoded in the Latin-1 transfer character-set but has 
been told to store the file as ASCII, or when it is sending a file encoded in a national or in¬ 
ternational character set but has been told to use ASCII as its transfer character-set, it 
strips diacritical marks and stores or sends the bare letters; for example, a cote becomes a 
cote (French), Fiifie becomes Fuse (German). For most Romance languages (Italian, 
Spanish, etc.), not much else can be done. 

Languages like Dutch, Norwegian, Danish, Swedish, and German, however, have rules for 
changing accented or other special characters into the plain letters A-Z. These rules are 
shown in Table 9-8 (in which Scandinavian means Danish, Finnish, Norwegian, or 
Swedish). Since Kermit does not know what language a file is written in, you must tell it. 
Here’s the command: 

SET LANGUAGE name 

Tells C-Keimit which language text files are written in so it can apply language- 
specific transliteration rules when converting between ASCII and a national or inter¬ 
national character set. Type a question mark to see which languages are supported by 
your C-Kermit program, for example: 

C-Kermit >set language ? One of the followings 
danish dutch finnish french 

german icelandic norwegian none 

russian Swedish 

C-Kermit>set language finnish 

NONE, which is the default, means that no special language rules should be applied. 

If you SET LANGUAGE to dutch, french, german, ICELANDIC, or any of the Scan¬ 
dinavian languages Danish, Finnish, Norwegian, or Swedish, you get the effects shown 
in Table 9-8 when translating into ASCII from an 8-bit character set or from a 7-bit ISO 
646 national version, but not in the other direction. The language-specific translations are 
not invertible. 
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Table 9-8 Language-Specific Transliteration Rules 


Character 

Dutch 

French 

German 

Icelandic 

Scandinavian 

A 

- 

- 

- 

- 

Aa 

a 

- 

- 

- 

- 

aa 

A 

- 

- 

Ae 

- 

Ae 

a 

- 

- 

ae 

- 

ae 

JE 

- 

- 

- 

Ae 

Ae 

X 

- 

- 

- 

ae 

ae 

0 

- 

- 

Oe 

Oe 

Oe 

6 

- 

- 

oe 

oe 

oe 

GE 

- 

Oe 

- 

- 

- 

oe 

- 

oe 

- 

- 

- 

0 

- 

- 

- 

- 

Oe 

0 

- 

- 

- 

- 

oe 

U 

- 

- 

Ue 

- 

Ue 

ii 

_ 

_ 

ue 

— 

ue 


y ij - - 

B - - ss 


D 

- 

- 

- 

D 

- 

6 

- 

- 

- 

d 

- 

I> 

- 

- 

- 

Th 

- 

D 

- 

- 

- 

th 

- 


You can find out your current character sets and language with the SHOW file, show 
languages, or show character-sets commands, for example: 

C-Kermit> set xfer ch latinl 
C-Kermit> show lanq 

Language-specific translation rules: Icelandic 
File Character-Set: ASCII 
Transfer Character-Set: Latin-1 

C-Kermit> 

To illustrate the use of the set language command, let’s transfer our German file again, 
and suppose again that the file is to be printed on a device that does not have the German 
special characters. We can convert the German characters to ASCII without any loss of 
information by using our special language rules: 
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MS-Kermit> set file character-set cp437 
MS-Kermit> set transfer character-set latinl 
MS-Kermit>connect 
$ kermit 

C-Kermit> set file character-set ascii 
C-Kermit> set language german 
C-Kermit> receive 
Alt-X 

MS-Kermit> send modem.txt 
MS-Kermit>connect 
C-Kermit> type modem.txt 

Wer ein Selbstwaehl-Modem hat, muss zur Herstellung der Verbindung 
mit dem anderen Rechner die Waehlkommandos eintippen. Man kann zur 
Kermit-Kommandoebene zurueckgelangen durch Eintippen der 
'Rueckkehrsequenz'. 

$ 

The umlaut-a’s have become ae’s, the umlaut-u’s are now ue’s, and the German double-s 
is two s’s—perfectly acceptable and proper German. Note, however, that these rules can 
not be applied in the opposite direction. For example, if oe were always translated to 6, 
then Kommandoebene would be improperly written as Kommanddbene. 


SET language RUSSIAN has a special meaning. If C-Kermit’ s file character-set is one of 
the Cyrillic ones (KOI8, Cyrillic-ISO, etc.), but the transfer character-set is ASCII, 
C-Kermit uses Short KOI in place of ASCII in the Kermit packets. This lets you send, for 
example, a Latin-Cyrillic file in Short-KOI form, or receive a file in Short-KOI form and 
store it in a proper 8-bit Cyrillic character set. This is useful when the one of the two 
computers does not support Cyrillic characters. For example, here we send a short file 
composed of both Roman and Cyrillic characters from a Russian computer running 
C-Kermit to a CP/M microcomputer running Kermit-80: 


C-Kermit> set file character-set koi8 (Translate from this) 
C-Kermit> set xfer character-set ascii (to this) 

C-Kermit> set language russian (using Short KOI) 

C-Kermit >send kepmit.txt (Send a file) 

Ctrl- C] (Escape back to micro) 

Kermit-80>receive (Receive the file) 

(The file is transferred) 


Kermit-80> type kepmit.txt (Take a look at it) 

protokol pereda-i fajlow KERMIT. 


ppf razrabotan w sootwetstwii so standartom ISO 7498 "|talonnaq 
modelx wzaimodejstwiq otzayplh sistemy princip raboty ppf 
zakl'-aetsq w obmene paketami KERMIT mevdu kompxywerami. format 
paketow KERMIT: 


+ - + - + - + - + — — — - + - + 

? MARK ? LEN ? SEQ ? TYPE ? DATA ? CHECK ? 

+ - + - + - + - + — — — - + - + 
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MARK - marker paketow KERMIT; 

LEN - dlina paketa; 

SEQ - nomer paketa; 

TYPE - tip paketa; 

DATA - dannye; 

CHECK - kontrolxnaq summa. 

Kermit-80> 

In the Short-KOI result, the uppercase words are English and the lowercase words are 
Russian. Question marks indicate characters that could not be translated. For example, 
the original text had vertical bars (j) in the diagram, but since vertical bar is the Short 
KOI notation for the Cyrillic letter 3 (see Table VIII-6), we can’t use vertical bars to 
represent themselves. 

Transferring 8-Bit Text Files in the 7-Bit Environment 

The Japanese-EUC and Latin/Cyrillic transfer character sets contain a preponderance of 
8-bit characters. Does this mean that you must pay a heavy performance penalty when 
transferring Japanese or Russian text over a 7-bit connection? 

As part of its international text transfer capability, the Kermit protocol has been fitted with 
a locking shift mechanism, explained in Chapter 8, pages 162-164. Rather than prefix 
each 8-bit byte with an additional character, Kermit shifts into and out of 8-bit character 
sequences much as you push the Caps Lock key on your keyboard. Locking shifts are 
used automatically whenever you have told Kermit to SET parity to anything but none 
and the other Kermit agrees to use them. 29 

Translating without Transferring 

Since the facilities for translation are already in place for connect sessions and file trans¬ 
fer, C-Kermit includes—at no extra cost—a command to translate a local file from one 
character set to another: 

TRANSLATE filel csl cs2 [file2 ] 

Translate the local file filel from the character set csl into the character set cs2. Both 
character sets may be selected from C-Kermit’s repertoire of file character sets. The 
result is stored in file2 or (if file2 is not specified), displayed on your screen. 

Synonym: XLATE. 

As with terminal connection and file transfer, an intermediate standard character set is 
used in translation. If the target character-set ( cs2) is Cyrillic (CP866, KOI8, Short KOI, 


29 Other Kermit programs that support this feature include MS-DOS Kermit and IBM Mainframe Kermit. 
See Table 1-1 on page 8 for a comparison of the capabilities of different Kermit programs. 
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etc.), Latin/Cyrillic is the intermediate set. Japanese EUC is used as the intermediate set if 
either one of the files is Japanese. If either one of the sets is Latin-2 or CP852, Latin-2 is 
used. Otherwise, if it is Roman-based, Latin-1 is used. 

Here’s an example in which a Swedish-language electronic mail message has been re¬ 
ceived and then saved to disk. It is encoded in Swedish 7-bit ISO 646, but needs to be 
converted to Latin-1 for printing: 

C-Kermit> xla diab.msq Swedish latinl diab.lat 
C-Kermit> type diab.lat 
From: bl@diab.se (Benny Lofgren) 

Subject: C-Kermit 5a(177) 

Date: Thu, 30 Jan 92 12:55:58 MET 

Ar det annonserat n&gon nyare C-Kermit an 5A(177)? Jag har 
kompilerat upp den med TCP/IP-stod pit DS90, och det verkar 
fungera bra. Kan lagga upp bin&ren pit klubben. Fdljande 
entry har jag lagt till i makefilen: 

#DIAB DS90, DNIX 5.3 or later, with HDB UUCP, nap, rdchk, TCP/IP 
dnix5r3net: 

C-Kermit >print diab.lat (Looks good, print it) 

In case you are not lucky enough to have a Latin-1 capable printer, you can use the SET 
language command with the TRANSLATE command in exactly the same way it is used in 
file transfer. Here we convert the Swedish message for printing on an ASCII-only printer: 
C-Kermit> set language Swedish 

C-Kermit> xla diab.msq Swedish ascii diab.asc (Translate) 
C-Kermit> type diab.lat (Check it) 

From: bl@diab.se (Benny Loefgren) 

Subject: C-Kermit 5a(177) 

Date: Thu, 30 Jan 92 12:55:58 MET 

Aer det annonserat naagon nyare C-Kermit aen 5A(177)? Jag har 
kompilerat upp den med TCP/IP-stoed paa DS90, och det verkar 
fungera bra. Kan laegga upp binaeren paa klubben. Foeljande 
entry har jag lagt till i makefilen: 

#DIAB DS90, DNIX 5.3 or later, with HDB UUCP, nap, rdchk, TCP/IP 
dnix5r3net: 

C-Kermit> print diab.asc (Looks OK, print it) 

See how the special characters were converted according to the rules listed in Table 9-8: 
a-ring to aa, and so on. 


(Translate) 
(Check it) 
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One-Sided Translation 


International character-set support is a relatively recent addition to the Kermit file transfer 
protocol, and you won’t find it in every Kermit program. As of this writing, it is available 
in MS-DOS Kermit 3.0 and later, in Kermit-370 4.2 and later for the major IBM main¬ 
frame operating systems, and in C-Kermit itself. 


That doesn’t mean you can’t use C-Kermit’s translation features with other Kermit 
programs that don’t support this feature. Whenever you send a file from C-Kermit to a 
non-intemationalized Kermit on a computer that happens to support one of Kermit’s trans¬ 
fer character-sets, have C-Kermit translate the file in the normal way, for example: 

C-Kermit >set file char cp437 
C-Kermit> set xfer char latinl 
C-Kermit> sen oofa.txt 

The other Kermit does no translating, but it doesn’t have to. 

If a local file is encoded in any character set that is also supported by the other computer, 
you can use the transparent transfer character-set to send it from C-Kermit, in which 
case your current file character-set setting is ignored. 

You can also use C-Kermit’s TRANSLATE command to pre- and/or postprocess transferred 
files. In this example, C-Kermit running on an Apple Macintosh with A/UX uploads an 
Icelandic-language file to a bulletin board system (BBS) that has Kermit protocol built in, 
but which does not support character-set translation. The BBS is on a PC that uses Code 
Page 850. C-Kermit translates the file from Macintosh Latin to CP850 and then sends it 
without further translation: 

C-Kermit> type kermit.txt 

Af hverju er Kermit svona vinsaell? Hann er 6dyr og gddur. Med 
Kermit getur pu tengst tolvum, stdrum eda litlum, naer og f jaer. 

Pu getur skiptst A upplysingum, k paegilegan og oruggan h&tt, vid 
naestum hvada tolvu sem er. Pu getur tengst frdttakerfum, 
verslunum, pdstkerfum, bonkum, verdbrdfabonkum og sent og tekid k 
m6ti skram. Pu getur skiptst k gognum vid vini og n&granna, pd 
peir eigi odruvisi tolvu en pu. Pu getur unnid heiman irk pdr. 
Kermit getur tengt pig vid "netid." Notid imyndunaraflid. Med 
nutima alpjddlegu simakerfi og 5rt vaxandi taekni i sima 
og tolvurrtcilum eru ykkur engin takmork sett. 

C-Kermit> translate kermit.txt macintosh-latin cp850 kermit.850 
C-Kermit >set transfer character-set transparent 
C-Kermit> send kermit.850 

When the remote computer supports only ASCII, C-Kermit can send files to it using ASCII 
as the transfer character-set, perhaps together with C-Kermit’s SET language command 
for language-specific rules. In this example, we upload the same Icelandic text file to 
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another BBS, but this BBS supports neither the Kermit protocol nor any 8-bit character 
sets, so we use the rules from Table 9-8 to transliterate the Icelandic letters to ASCII: 


C-Kermit> set file char mac 
C-Kermit> set xfer char asc 
C-Kermit >set lanq icelandic 
C-Kermit>transmit kermit.txt 


(Macintosh-Latin) 
(ASCII) 

(Icelandic rules) 
(Unguarded upload) 


Af hverju er Kermit svona vinsaell? Hann er odyr og godur. Med 
Kermit getur thu tengst toelvum, storum eda litlum, naer og fjaer. 

Thu getur skiptst a upplysingum, a thaegilegan og oeruggan hatt, vid 
naestum hvada toelvu sem er. Thu getur tengst frettakerfum, 
verslunum, postkerfum, boenkum, verdbrefaboenkum og sent og tekid a 
moti skram. Thu getur skiptst a goegnum vid vini og nagranna, tho 
their eigi oedruvisi toelvu en thu. Thu getur unnid heiman fra ther. 
Kermit getur tengt thig vid "netid." Notid imyndunaraflid. Med 
nutima althjodlegu simakerfi og oert vaxandi taekni i sima 
og toelvumalum eru ykkur engin takmoerk sett. 


C-Kermit> 


Finally, it is conceivable that a Kermit program attempts to perform character-set trans¬ 
lation but does so incorrectly, or at least not according to your preferences. You can 
prevent two Kermit programs from negotiating automatic translation with each other by 
issuing the command SET attributes character-set off, which forces the transfer 
character-set to be TRANSPARENT. 


Labor-Saving Devices 

If you always work in a particular language and character-set environment, you can save 
yourself some work by putting the appropriate commands in your C-Kermit initialization 
file so they will be in effect whenever you run C-Kermit. Say, for example, you always 
use the Italian character set on the computer where you run C-Kermit and you often trans¬ 
fer Italian-language text files from there to your MS-DOS PC, where they must be en¬ 
coded in the PC’s character set, CP437. Put the following commands in your C-Kermit 
initialization file (CKERMIT. INI or . kermrc): 

set file character-set italian 
set transfer character-set latinl 

If you add the corresponding commands to the initialization file for Kermit on your PC 
(MSKERMIT.INI): 

set file character-set cp437 

set transfer character-set latinl 

set terminal character-set italian 

you will never have to worry about character sets again and you can forget everything you 
have read in this chapter. 
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Chapter 10 


Transferring Files without the 
Kermit Protocol 


Not all computers have Kermit software available. For example, certain dialup data ser¬ 
vices, bulletin board systems (BBSs), and remote typesetting services don’t offer Kermit 
file transfer capability. The same might be true of various types of data-taking and labora¬ 
tory devices, as well as of certain application software, particularly electronic mail and 
text editors, found on the hosts or services that you access with C-Kermit. 

In such situations, C-Kermit lets you transmit files to and capture files from computers, 
services, or applications that don’t support Kermit file transfer. This is done without error 
detection or correction of any kind : 

Data transferred without error correction is subject to corruption, loss, inter¬ 
ference, misinterpretation, duplication, and other types of damage. 

In most cases, only textual data can be transferred using the methods described here, and 
often only 7-bit text. In general, these methods work only for a single file, not for a group 
of files. 

Before proceeding, consider the alternatives. Can you get Kermit for the other computer? 
(See page 9.) Or can you persuade the proprieters of the remote service to support the 
Kermit protocol? Is a network connection available with its own file transfer or sharing 
method? Is there some kind of removeable storage medium common to both computers— 
compatible diskettes or tapes? If none of these options is viable, read on. 
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Downloading to C-Kermit 


Unguarded downloading is the act of capturing a file from a remote computer without its 
knowledge. It thinks it is simply displaying the file on your screen. You, however, are 
surreptitiously recording the screen characters on your disk during your C-Kermit 
CONNECT session. Here are the commands to use: 

LOG SESSION [filespec [ { APPEND, NEW } ] ] 

The characters that are sent to C-Kermit during connect mode are recorded in the 
specified file. The default filename is SESSION.LOG. All current communication set¬ 
tings are used, including duplex, flow control, shift-in/shift-out, and parity. Xon/Xoff 
flow control can be used to help prevent loss of data. If parity is in use or the terminal 
bytesize is set to seven, the 8th bit of each character is discarded. Character-set trans¬ 
lations implied by your terminal character-set settings are performed. A new 
session log file is created unless you include the APPEND option, which adds the 
recorded material to the end of the named file, if it exists, and otherwise creates a new 
one. When a new log is created, any previously existing file with the same name (on 
the same device, in the same directory, on the same computer) is destroyed, unless the 
underlying operating system supports multiple versions of the same file (as do VMS 
and Open VMS). 

SET SESSION-LOG { BINARY, TEXT } 

(UNIX only) Specifies the recording format for the session log. TEXT is the default, 
meaning that certain control characters are discarded, including Carriage Return 
(ASCII 13), Null (ASCII 0), and Delete (ASCII 127). binary means that every 
character that arrives is recorded. Character-set translations are done in both cases un¬ 
less you use SET TERMINAL CHARACTER-SET TRANSPARENT to disable them. SET 
SESSION-LOG binary does not mean you can capture binary files such as executable 
programs. 


To capture a remote file, display it on the other computer while logging your session with 
C-Kermit. The trick is to avoid capturing an excessive amount of extraneous data, such as 
commands, system prompts, and so forth. Here is an example in which you use C-Kermit 
to log in to a VAX and copy a coveted recipe. The SET FLOW, PARITY, and SESSION-LOG 
commands are included for emphasis; the settings shown are the defaults, so you won’t 
need to give these commands unless you have previously changed the settings: 


C-Kermit> set modem hayes 
C-Kermit> set line /dev/ttyh8 
C-Kermit> set speed 2400 
C-Kermit> set flow xon/xoff 
C-Kermit> set parity even 
C-Kermit> set session-loq text 
C-Kermit> dial 7654321 
Connection completed. 


(Select modem type) 

(Select communication device) 
(and speed) 

(and flow control) 

(and parity) 

(and session log format) 

(Dial the phone number) 
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C-Kermit >connect 
BON GIORNOl 


(Begin terminal emulation) 


Username: qarfield (Login) 

Password: _ (Supply your password) 

So far everything is normal. Now comes the tricky part. You must type the command to 
display the text file you want to capture, but without the terminating carriage return (for 
UNIX, the command is cat, for most other systems it is type). Then escape back, turn 
on the session log, CONNECT again, and then type the carriage return. When the system’s 
prompt reappears, escape back again, close the session log, and you’ve got the file, or at 
least as much of it as appeared on your screen, plus one system prompt at the end, which 
you can remove with a text editor. 

$ type lasaqna.recipe 
Ctrl-\C 

C-Kermit> loq sess lasagna.recipe 
C-Kermit >connect 
<RETURN> 

Ingredients: 

1 lb Moozarel' 

1 lb Rigotha 
1 lb tiny meatballs 

$** 

Ctrl -\C 

C-Kermit> close session 
C-Kermit> type lasagna.recipe 
Ingredients: 

1 lb Moozarel' 

1 lb Rigotha 
1 lb tiny meatballs 

$’* 

C-Kermit> 

Now edit the file to remove or correct any unwanted material—system dialog, prompts, 
messages, noise interference, and so on. 

To ensure that the captured file is as close to the original as possible, you should make 
sure the host is not sending any characters that are not part of the file. For example, you 
should take whatever measures the host allows to turn off services like line or word wrap, 
tab expansion, pausing at end of each screenful, and so on, as well as eliminating other 
possible sources of interference such as messages from other users, e-mail notifications, 
alarm clocks, or host-generated mode lines. 

HINT: This process includes quite a few routine steps that could be easily automated in a 
script program. Chapters 11-13 cover script programming. 


(Don't press Return yeti) 
(Escape back) 

(Start the session log) 

(Go back) 

(and press carriage return) 
(The characters that appear) 
(on your screen are being) 
(recorded in the session log) 

(etc etc) 

(Prompt reappears) 

(Escape back again) 

(Close the session log) 

(Check it out) 

(Looks good, mmmmmml) 


(etc etc, good it worked) 
(Notice the system prompt) 
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Uploading from C-Kermit 


How do you create a text file on a computer? You set up a process on the computer that 
copies your keystrokes to a disk file. This could be a simple copy process, or it could be a 
text editor. When you have finished entering characters into the file, you type a special 
key or sequence to tell the copy process or text editor to close the file. The simplest way 
to create a file in UNIX is like this: 

$ cat > file.new 
I am typing some characters. 

They are being copied into 
file.new. 

Ctrl-D 
$ 

and in VMS and Open VMS it is: 

$ create file.new 
I am typing some characters. 

They are being copied into 
file.new. 

Ctrl-Z 
$ 

Other systems, of course, have other n 

Now suppose you have a text file on your computer that you want to send to a remote 
computer that doesn’t have its own copy of Kermit. Instead of retyping the characters of 
the text file with your own fingers, you can set up the remote computer for creating a file, 
as shown in the previous examples, and then tell C-Kermit to imitate what you would do if 
you were typing the file at your keyboard. The remote computer should never know the 
difference. The command is: 

TRANSMIT filename 

Sends the characters of the file out the current communication device, just as if you 
were typing them in CONNECT mode. The TRANSMIT command obeys all current (and 
relevant) communications and terminal settings, including echo, parity, flow control, 
and shift-in/shift-out. Unless you say otherwise, the transmit command also dis¬ 
plays the transmitted data on your screen according to the current terminal echo 
setting. Synonym: XMIT. 

The most important factor affecting how the transmit command works is the current 
file type setting: 

SET FILE TYPE TEXT 

If the current file type is text, the transmit command treats each line of the file as 
an individual record. It reads a line, strips off the line termination characters (such as 
LF for UNIX or AOS/VS, CRLF for VMS or OS/2, CR for OS-9), and sends a single 


(Start the copy process) 

(Type characters into the file) 

(Ctrl-D closes the file) 

(and returns you to the prompt) 


(Start the copy process) 

(Type characters into the file) 


(Ctrl-Z closes the file) 

(and returns you to the prompt) 


aethods. 
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carriage return at the end of each line, just as you would do if you were typing the line 
yourself. Then it waits a certain amount of time for the remote system to echo a 
linefeed before sending the next line (so if your file contains long lines, be sure the 
remote host or service has been told not to wrap them). Characters are translated ac¬ 
cording to the current terminal character-set setting. If you want to avoid trans¬ 
lation, SET TERMINAL CHARACTER-SET TRANSPARENT before giving the TRANSMIT 
command. 

SET FILE TYPE BINARY 

The file’s bytes are sent exactly as they are stored on the disk with no conversion at 
all, and there is no synchronization between the two sides as there is with text file 
transmission. Use binary transmission with caution and skepticism. 

The standard text and binary transmission procedures might not work in every case, so 
C-Kermit also offers you the customary selection of SET commands to modify their opera¬ 
tion as needed: 

SET TRANSMIT ECHO { OFF, ON } 

Tells C-Kermit whether you want to see the transmitted characters echoed on your 
screen. The default setting is ON, in which case echoing is done according to the cur¬ 
rent terminal echo (duplex) setting. If the computer or device on the other end of 
the connection does not echo, you should SET TERMINAL ECHO ON (or SET DUPLEX 
HALF, same thing) if you want C-Kermit itself to display each character it sends, or 
SET TRANSMIT ECHO OFF if you don’t want the characters displayed. No echoing is 
more efficient. Synonym: SET XMIT ECHO. 30 

SET TRANSMIT EOF [ string ] 

Tells C-Kermit the character or characters to send after it sends the last line of the file, 
or when you type Ctrl-C to interrupt a transmission. Normally, nothing is sent at the 
end of the file. To include control characters in the string, use backslash codes such as 
\4 for Ctrl-D or \26 for Ctrl-Z (see Table VIII-2 on page 462). To cancel a previous 
TRANSMIT EOF setting, type this command without specifying a string. Examples: 

C-Kermit >set transmit eof \4 (Send Ctrl-D on EOF) 

C-Kermit >set transm eof \26 (Send Ctrl-Z on EOF) 

C-Kermit >set xfer eof (Send nothing on EOF) 

The next example shows a typical sequence that might be sent to a text editor to exit 
from text insert mode, save the file, and exit: 

C-Kermit> set xf eof \26save\13\exit\13 

The TRANSMIT EOF setting applies to both text and binary file transmission. 


30 All the set transmit commands can also be entered as set xmit. 
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SET TRANSMIT FILL number 

The TRANSMIT command normally sends a blank line as a sequence of two carriage 
returns. Some computer text entry systems, however, treat two carriage returns in a 
row as an “end of file.” This command lets you specify a single character to insert 
into each blank line so it won’t be blank any more. The number is the code for the 
character, such as 32 for ASCII space (blank). This setting applies only in text mode. 
Examples: 

C-Kermit> set transmit fill 32 (Add space to empty lines) 

C-Kermit> set transm fill (Don't fill empty lines) 

SET TRANSMIT LINEFEED { OFF, ON } 

SET transmit linefeed ON tells C-Kermit to send both carriage return and linefeed at 
the end of each line, rather than just a carriage return. This command applies only in 
text mode. The default is off, meaning that only a carriage return is sent at the end of 
each line. Examples: 

C-Kermit >set transmit linefeed on 
C-Kermit >set xm li off 

SET TRANSMIT LOCKING-SHIFT { OFF, ON } 

If you want to transmit 8-bit data over a 7-bit connection, and the remote computer or 
service supports Shift-In and Shift-Out (Ctrl-N and Ctrl-O) as a way of shifting be¬ 
tween 7-bit data and 8-bit data, you can use SET TRANSMIT LOCKING-SHIFT ON to have 
Kermit provide the shifting. Use SET TRANSMIT LOCKING-SHIFT OFF to cancel a pre¬ 
vious SET TRANSMIT LOCKING-SHIFT ON command. Applies only in text mode. 

SET TRANSMIT PAUSE number 

If the FILE TYPE is TEXT, this command tells C-Kermit to pause the given number of 
milliseconds (1 /1000 of a second) after sending each line. If the file type is 
binary, the pause occurs between each character. 

SET TRANSMIT PROMPT number 

Use this command to tell C-Kermit to wait for some character other than linefeed as 
permission to send the next line. The number is the code for the character to wait for, 
such as 17 for Control-Q (Xon). A value of zero tells C-Kermit not to wait at all, but 
to send all the characters of the file without waiting for any response, which is useful 
for transmitting text to devices that do not echo a suitable, unique character at the end 
of each line. This command applies only in text mode. In binary mode, the TRANSMIT 
command never waits for a response. 

C-Kermit> set file type text (Use text mode) 

C-Kermit> set transmit prompt 17 (Wait for Xon) 

C-Kermit> set transm pr 0 (Don't wait for anything) 

You can examine set transmit settings with the show transmit (or show xmit) 
command: 
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C-Kermit >show xmit 
File type: text 
Terminal echo: remote 
Terminal character-set: transparent 
Transmit EOF: none 
Transmit Fill: none 
Transmit Linefeed: off 

Transmit Prompt: 10 (host line end character) 
Transmit Echo: on 
Transmit Locking-Shift: off 
Transmit Pause: 0 milliseconds 
C-Kermit> 


TRANSMIT Examples 

Now let’s work through two examples. In the first, we upload a text file to a UNIX com¬ 
puter. On the UNIX end we simply cat (type) from the keyboard to a file. C-Kermit is 
told to transmit the file, followed by a Ctrl-D to close it. 


$ kermit 

C-Kermit >set modem hayes 
C-Kermit >set line /dev/ttyh8 
C-Kermit >set speed 2400 
C-Kermit >set flow xon/xoff 
C-Kermit >dial 7654321 
C-Kermit >connect 

WELCOME TO THE HOLLYWOOD SCRIPT 


(Start Kermit) 

(Select modem type) 

(Select communication device) 
(and speed) 

(and flow control) 

(Dial the phone number) 

(Begin terminal emulation) 
AGENCY 


login: olga 
Password: 


$ cat > stormy.txt 
Ctrl -\c 

C-Kermit >set transm eof \4 
C-Kermit >transmit stormy.txt 
THE DARK AND STORMY NIGHT 


(Log in) 

(Start the copy process) 
(Escape back to C-Kermit) 
(Send Ctrl-D when done) 
(Transmit the file) 

(The lines are displayed) 


It was a dark and stormy night in Plainville. Everyone was huddled 
inside their houses, safe and dry. In the old abandoned house on 
Main Street, a sinister light shone from the attic window... 
etc etc 

C-Kermit> (C-Kermit prompt returns) 

C-Kermit> connect (Go back to the remote system) 

$ cat stormy.txt (Look at the file) 

THE DARK AND STORMY NIGHT 


It was a dark and stormy night in Plainville. Everyone was huddled 
inside their houses, safe and dry. In the old abandoned house on 
Main Street, a sinister light shone from the attic window... 
etc etc 
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(Log out) 
(All done) 


$ 

$ exit 

Communications disconnect. 

C-Kermit> exit 
$ 

This example was easy because C-Kermit’s default settings are well suited for a direct 
dialup connection to the remote UNIX system. The UNIX system has a simple mecha¬ 
nism for entering text from the keyboard into a file; it does not react adversely to blank 
lines and it echoes a linefeed whenever it receives a carriage return to indicate it is ready 
for another line. 


Now let’s see how far we can push C-Kermit by trying to upload the same file to an IBM 
mainframe with the VM/CMS operating system, using a text editor on the mainframe. 
The connection is linemode and half duplex, so we must wait for the editor’s prompt 
(which is a period followed by an Xon, or Ctrl-Q) before sending the next line or else data 
will be lost. The text editor, Xedit, leaves text insertion mode if it gets a blank line and 
therefore must have a fill character in case the file contains blank lines. The fill character 
is chosen to be capital X (ASCII 88) because a printable character is required—blank 
won’t do. The EOF string is set to be a carriage return (\13), which sends a blank line, 
putting the editor back into command mode, followed by the commands to save the file 
(save\13) and exit (qq\13). 


$ kermit 

C-Kermit> set modem hayes 
C-Kermit >set line /dev/ttyh8 
C-Kermit> set speed 2400 
C-Kermit> set duplex half 
C-Kermit> set flow none 
C-Kermit> set parity mark 
C-Kermit> dial 8765432 
Connection completed. 
C-Kermit>connect 


(Start C-Kermit) 

(Select modem type) 

(Select communication device) 
(and speed) 

(Connection is half duplex) 
(No Xon/Xoff flow control) 
(Mainframe uses MARK parity) 
(Dial the phone number) 

(Begin terminal emulation) 


VIRTUAL MACHINE/SYSTEM PRODUCT—CUVMB —PRESS BREAK KEY 


Ctrl -\B 
1 

. login olqa 

Enter password: XXXXXXXX 

LOGON AT 15:28:14 EDT THURSDAY 
VM/SP REL 5 04/19/88 19:39 

CMS 

. xedit stormy txt 
. i 

DMSXMD573I Input mode: 

Ctrl-\C 


(Send BREAK) 

(Log in) 

(Half duplex; password echoes) 
09/21/92 

(Start the editor) 

(Put it in text input mode) 

(Escape back to C-Kermit) 
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C-Kermit> set transm fill 88 (Fill blank lines with X) 
C-Kermit> set transm prompt \17 (Wait for Xon) 

C-Kermit >set transm eof \13save\13qq\13 
C-Kermit> transmit stormy.txt (Send the file) 

THE DARK AND STORMY NIGHT (The echoed lines are displayed) 

X 

It was a dark and stormy night in Plainville. Everyone was huddled 
inside their houses, safe and dry. In the old abandoned house on 
Main Street, a sinister light shone from the attic window... 
etc etc 


C-Kermit> 

C-Kermit>connect 


(Prompt returns when done) 
(Return to the mainframe) 


Ready; T=0.02/0.06 15:29:11 

. If stormy (Make sure file is there) 

STORMY TXT (It is) 

Ready; T=0.01/0.01 15:29:16 

. type stormy txt (Take a peek) 

THE DARK AND STORMY NIGHT 
X 

It was a dark and stormy night in Plainville. Everyone was huddled 
inside their houses, safe and dry. In the old abandoned house on 
Main Street, a sinister light shone from the attic window... 
etc etc 


Ready; T=0.01/0.01 15:29:20 

. logout (bog out from the mainframe) 

CONNECT= 00:01:11 VIRTCPU= 000:00.12 TOTCPU= 000:00.32 
LOGOFF AT 15:29:25 EDT THURSDAY 09/21/92 

Ctrl ~\C (Escape back to C-Kermit) 

C-Kermit>exit 
$ 

The X’s can be removed with a text editor (such as Xedit, the same editor that made you 
put them there in the first place). 


Encoding 8-Bit Data Files for Transmission 

Unguarded transfer of binary files or 8-bit text files is an iffy proposition at best. If even 
one byte is lost or corrupted, terrible damage could result. And it is usually not easy to 
repair a damaged binary file with a text editor, as you can do with a text file. It is often 
better to convert a binary or 8-bit text file into simple lines of printable ASCII text, then 
up- or download it in text mode, and then convert it back into its original form. The 
easiest, most reliable, and most portable format is called “hex” (hexadecimal), in which 
each 8-bit byte is translated into two printable hexadecimal digits taken from the set 
0123456789ABCDEF. Short lines are formed, composed of only these characters. A file 
of this form is slightly more than twice the length of the original, but it is immune to any 
known translation or transparency problems. A pair of short C-language programs for 
hexifying and dehexifying is included in Appendix X. 
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Other encoding methods might be more efficient. For example, a pair of programs, uuen- 
code and uudecode, is available on most UNIX computers, but not necessarily on other 
systems. The encoding is more efficient than hex, but also uses a bigger alphabet that 
might cause transparency or translation problems, for example with EBCDIC hosts. 

There are many other file encoding, compaction, and archiving techniques available too. 
Use whatever works best for you. The primary considerations are transparency (can the 
encoded data survive the passage to the other computer?) and portability (can you 
reconstruct the original data after transmitting to another computer?). 
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Chapter 11 

Command Files, Macros, and 
Variables 


oooo 

If you have digested the material in the preceding chapters and applied the ex¬ 
amples to your own connections, you should be comfortable using C-Kermit to 
accomplish your communication chores by hand. But manually operating com¬ 
munications software does not make the best use of your time. In these three 
chapters, you’ll see how to automate all the procedures you have learned so far. 
By the end of Chapter 13 you will be able to create and use commands that 
make the connection for you, carry on scripted dialogs with remote hosts or ser¬ 
vices, and transfer data automatically, even when you are elsewhere. 

This chapter shows you how to group commands together into command files 
and macros so you can execute many commands by issuing a single command. 
It also introduces the concept of variables and describes the kinds of variables 
offered by C-Kermit. 

Chapter 12 shows you how to “program” C-Kermit to make decisions, execute 
commands repeatedly in loops, read and write files, and so on, using C-Kermit 
commands very similar to the ones you’re already accustomed to. Finally, in 
Chapter 13 these somewhat abstract concepts are put to practical use. The 
remainder of the book is devoted to reference material. 
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Command Files Revisited 


You first encountered command files back in Chapter 2. There you learned that you could 
put any Kermit commands at all in a file and then execute all of them by giving a single 
command, TAKE, at the C-Kermit prompt. In this example we compose a short command 
file on a VAX, where VMS’s create command is the easiest way to make a short text 
file. Of course you could also use any text editor or word processor that is capable of 
creating a plain-text file. 

$ create escape.tak (Create a command file) 

set escape 29 (Enter text from the keyboard) 

show escape 

''Z (Ctrl-Z closes the file) 

$ 


Now we execute the command file by telling C-Kermit to TAKE it: 

$ kermit (Start C-Kermit) 

C-Kermit 5A(188), 23 Nov 92, OpenVMS VAX 
Type ? or HELP for help 
C-Kermit >take escape.tak 
Escape character: Ctrl-] (ASCII 29, GS) 

C-Kermit> 

If the command file is not in your current directory, you have to supply the complete file 
specification: 

C-Kermit> take $diskl:[olqalescape.tak 


A command file can include as many C-Kermit commands as you like, including TAKE 
commands for other command files. The take command normally executes all the com¬ 
mands in the file, from the beginning to the end, or up to the first command that tells it to 
stop, such as exit or quit. If a command has a syntax or execution error, C-Kermit prints 
an error message and goes on to the next command in the file. For example, if you ex¬ 
ecuted a command file called toast.tak that looked like this: 


echo Making toast... 
set toaster dark 
toast two slices 
echo Time for breakfast. 

The result would be: 

C-Kermit >take toast.tak 
Making toast... 

?No keywords match - toaster 
?Invalid: toast two slices 
Time for breakfast. 

C-Kermit> 


Valid command 
Invalid command 
Invalid command 
Valid command 


But you might not want C-Kermit to be so tolerant of failing commands. 
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The SET TAKE command can be used to change how the take command works: 

SET TAKE ECHO { ON, OFF } 

OFF means that lines from the command file are not displayed on your screen. This is 
the normal and default setting. ON means that each command is displayed on your 
screen at the time C-Kermit reads it from the file. This is useful to help you locate er¬ 
rors in command files. 

SET TAKE ERROR { ON, OFF } 

off, the normal and default setting, means that errors in command files do not cause 
termination. ON means that any command in the file that has a syntax or execution er¬ 
ror terminates execution of the command file. 

Execution errors occur when a command is syntactically (grammatically) correct but 
C-Kermit can’t carry it out successfully, for example, if you tell C-Kermit to take, type, 
or send a file that you don’t have read access to. 


Command File Example 

To illustrate the usefulness of the take command, suppose that on a certain day you need 
to upload and download an odd mixture of text and binary files totaling many millions of 
bytes in size. How much time are you willing to devote to this task? If you do it inter¬ 
actively, you’ll have to sit and watch your screen constantly and enter new commands at 
the right times. It could take all day. With a command file, each command is executed 
when the previous one completes, no sooner, no later; no time is wasted, and while all this 
is happening you can be off somewhere else doing something that may be more fun than 
watching Kermit’s file transfer display. Here’s a sample command file for the job; let’s 
call it BIGJOB.TAK : 31 


set take error on 
log transactions 
set file type text 
send daily.* 
send weekly.* 
send monthly.* 
get orders.new 
set file type binary 
send budget.wks 
send salary.wks 
set file type text 
mail ok.txt boss 
bye 


Quit if there's an error 
Keep a record of what happened 
Transferring text files 
Upload daily reports 
Upload weekly reports 
Upload monthly reports 
Download new orders 
Switch to binary mode 
Upload budget worksheet 
Send salary worksheet 
Back to text mode 
Send e-mail when done 
Logout remote job 


31 Switching between text and binary mode in this way depends on the remote server’s ability to read the 
file type from C-Keimit’s attribute packet. See Table 1-1 on page 8. C-Kermit, MS-DOS Kermit, and 
IBM Mainframe Kermit have this capability. 
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After you’ve composed this file with a text editor and saved it on disk, you can start Ker- 
mit, make your connection to the remote computer, log in, start Kermit there, put it in 
server mode, escape back to C-Kermit, and take the command file: 


$ kermit 

Ready to dial... 
C-Kermit> dial 765-4321 
C-Kermit>c 
. login olqa 
Password: 


(Start kermit) 

(Message from init file) 
(Dial the number) 

(CONNECT to remote computer) 
(Enter username) 

(Enter password) 


. kermit 

Kermit-CMS >server 

Ctrl-\C 

C-Kermit> take biqjob.tak 


(Start Kermit on remote computer) 
(Put it in server mode) 

(Escape back to C-Kermit) 

(TAKE the command file) 


Later, when you come back from wherever you went, you can examine the transaction log 
to see what happened. Your electronic mail message (composed previously and stored in 
the file OK.TXT) is sent to the boss only if all the files were transferred successfully. The 
SET take ERROR ON command ensures that any errors terminate the command file before 
the message is sent so you won’t look like a fool. 


Nested Command Files 

When a command file itself contains take commands, the command files are said to be 
nested, one within the other. Any C-Kermit command is legal in a command file, includ¬ 
ing TAKE. In fact, one command file can take another, which takes yet another, which 
takes still another, and so on, to a nesting depth of about 20. This feature lets you create 
building-block command files that can be pieced together in different ways, possibly 
saving you much duplication of effort over the years. 

But there can be more down-to-earth, if less obvious, reasons for nesting command files. 
Suppose, for example, bigjob.tak encountered an error. The command file would ter¬ 
minate immediately, the C-Kermit prompt would return, but the connection to the remote 
computer would not necessarily be broken. If your absence from the office was longer 
than expected, you might have run up a large phone bill for nothing. But if you invoke 
BIGJOB.TAK from a superior TAKE file, it would regain control as soon as BIGJOB.TAK 
completed—successfully or not. Such a file might look like this: 

take bigjob.tak ; TAKE the command file 

hangup ; Hang up the phone when done 

Call this two-line superior command file biggerjob.tak and start it like this: 

C-Kermit >take biggerjob.tak 

Then, no matter how bigjob.tak may terminate, C-Kermit hangs up the phone without 
delay. 
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The C-Kermit Initialization File 

C-Kermit issues an automatic TAKE command for your initialization file whenever you 
start it. Your initialization file should contain commands that you wish to be executed 
whenever you start Kermit. For example, to select a particular modem type, communica¬ 
tion device, and speed, and to tell Kermit where to find your dialing directory, use: 

set modem ccitt ; My workstation has a CCITT modem 

set line /dev/cua ; Attached to this serial device 

set speed 2400 ; My dialing speed is 2400 bps 

set dial directory /usr/olga/phone-numbers 

In previous chapters, some other commands were suggested as likely candidates for your 
initialization file. Suppose, for example, you always want to use long packets, sliding 
windows, and a type-3 block check during file transfer. It is usually safe to set these 
protocol parameters all the time, because C-Kermit negotiates them downwards automati¬ 
cally if the other Kermit program can’t handle them. You could add these lines: 

set receive packet-length 1000 ; Long packets 

set window 4 ; Four window slots 

set block 3 ; 3-character CRC error checking 


Language and character-set related items might also be suitable for your initialization file. 
For example, if all your text files are written in Finnish using the Finnish version of ISO 
646, you would add these lines to ensure that your text files are always translated correctly 
during file transfer: 

set file character-set finnish ; I use Finnish on my computer, 

set xfer character-set latinl ; Latin-1 for transfer, and 

and this one to take care of terminal emulation to a Data General host: 

set term character-set dg ; DG International for CONNECT 

set term byte 8 ; 8-bit path to the host 

set command byte 7 ; and 7 bits to my terminal 


Practically any SET command is appropriate for your initialization file, as long as it is a 
setting you want in effect at all times, no matter which computers or services you are com¬ 
municating with. Here are a few examples: 


set delay 1 
set attrib date off 
set dial hangup off 
set escape 31 


I can escape back quickly 
New files get current date 
"ON" confuses my modem 
Escape = Ctrl-Underscore 


But if you use C-Kermit to connect to many different hosts or services, using a variety of 
connection methods, a single collection of settings is not enough. Instead, you need a way 
to switch quickly among a variety of environments, and this is where macros come in. 
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Command Macros 


“Macro” usually means “big,” but in computer language it means something small that 
stands for something bigger. Kermit macros are new commands that you create by com¬ 
bining existing commands (or even other macros). Like command files, macros give you 
a way to group commands together so you can execute a bunch of them with a single 
word. The command for making macros is: 

DEFINE name [ text ] 

This command creates a macro called name. The macro’s definition is the text follow¬ 
ing its name. This is normally a list of C-Kermit commands (possibly including 
names of other macros), separated by commas, but it can be any text at all. No inter¬ 
pretation, evaluation, or verification of the commands is done; the definition is taken 
literally. If a macro of the given name already exists, its definition is replaced by the 
one given. If no text follows the macro name, the named macro (if it exists) is 
removed from C-Kermit’s “macro dictionary” and becomes undefined. 

You can type the define command at the C-Kermit prompt, put define commands in 
command files, and even put them inside of other macro definitions. If you have taken the 
trouble to construct a macro that you want to use frequently, the best place to put its 
definition is in your C-Kermit initialization file. 

The macro name can be any reasonable character string that contains no spaces or control 
characters. Uppercase and lowercase letters are treated equivalently. The macro defini¬ 
tion can be up to about 1,000 characters in length. Here is an example you can try if you 
have C-Kermit running next to your bed: 

define alarm echo Good night 1, sleep 28800, echo \7\7\7Wake upl 

The macro’s name is: 

alarm 

The definition is: 

echo Good night., sleep 28800, echo \7\7\7Wake up! 

The define command puts the alarm macro in C-Kermit’ s macro dictionary, turning it 
into a new C-Kermit command: 

C-Kermit> alarm 
Good night. 

Eight hours later: 

<BEEPXBEEP><BEEP>Wake up! 

C-Kermit> 

The following command destroys the definition of the ALARM macro so you can’t use it 
any more: 
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C-Kermit>define alarm 


(This is like throwing your alarm clock out the window.) 

A common and straightforward use for macros is to group set commands together to al¬ 
low rapid switching among different kinds of connections, for example: 

define vax set parity none, set duplux full,- 
set flow xon/xoff, set handshake none 
def ibm-linemode set parity mark, set dupl half,- 
set handsh xon, set flow none 

Here two macros are created, the first named VAX and the second IBM-LINEMODE. 


Pay careful attention to punctuation: use commas to separate commands, and hyphen 
(dash) to continue a line. The final line of the definition, of course, must not end with a 
hyphen. If you accidentally omit a hyphen, the next line is taken as a new command, 
rather than part of the macro definition. 


file (including your initialization file), you can 


If your macro definition is in a command 
add trailing comments to each line: 

define vax - 

set parity none,- 
set command byte 8,- 
set terminal byte 8,- 
set terminal echo remote,- 
set flow xon/xoff,- 
set handshake none 


Macro for connecting to a VAX 

No parity 

8-bit data, 

from end to end 

The VAX echoes 

Use Xon/Xoff flow control 

No line turnaround handshake 


When a line is continued, trailing comments must come after the continuation character, 
not before it, and must be preceded by at least one space or tab. If you put a hyphen at the 
end of a trailing comment, the next line is considered part of the same comment. 


You can find out the definition of a macro with the show macro command: 

C-Kermit> show macro ibm-linemode 
ibm-linemode = set parity mark,- 
set dupl half,- 
set handsh xon,- 
set flow none 

The definition is shown one command per line, with commas separating the commands 
and hyphens showing line continuation. If you type SHOW MACRO without giving the 
name of a macro, C-Kermit shows you all the currently defined macros and their defini¬ 
tions. Even if you haven’t defined any macros, you will still see definitions for some of 
C-Kermit predefined macros, such as FATAL (explained in Chapter 12). 
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Using Macros 

Now that you know how to create macros, you might also want to know how to use them. 
There are two ways to use (invoke) a macro. The first and most natural way is simply to 
type its name at the C-Kermit prompt, either in full: 

C-Kermit> ibm-linemode 
or abbreviated unambiguously: 

C-Kermit>ib 

This way works as long as your macro does not have the same name as, and is not an ab¬ 
breviation of, a built-in C-Kermit command. 

The second way is with the DO command: 

DO macro-name 

Invokes the macro whose name is given. The macro name may be abbreviated to any 
length that still distinguishes it from the names of all other defined macros. Examples: 

C-Kermit> do ibm-linemode 
C-Kermit >do ibm 

The DO command removes any possible confusion between macros and built-in com¬ 
mands because it looks only in the macro dictionary. If you type a question mark at the 
C-Kermit prompt, the macro names are not listed. But if you type do followed by a space 
and a question mark, the names of all defined macros are listed: 

C-Kermit> do ? macro, one of the followings 
ibm-linemode vax 

C-Kermit> 

If you have defined a macro with the same name as a built-in command, the DO command 
is the only way to invoke it because C-Kermit gives priority to its built-in commands. If 
you always pick original names for your macros, there is no ambiguity and the DO com¬ 
mand need never be used. 

Macro execution can be controlled in the same ways as command file execution: 

SET MACRO ECHO { OFF, ON } 

Controls whether commands from the macro definition are echoed on your screen as 
C-Kermit reads them, macro ECHO is normally OFF, meaning that the commands are 
not shown. You can use SET MACRO ECHO ON for debugging. 

SET MACRO ERROR { OFF, ON } 

Controls whether an error—syntax or execution—in a command causes C-Kermit to 
terminate execution of the macro. Normally MACRO error is off. 

Macro execution can be interrupted at any time by typing Ctrl-C. 
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Macros that Invoke Macros 

Like command files, macros can be nested to any reasonable level. Just as command files 
can TAKE other command files, macros can invoke other macros. For example: 

define modem set modem hayes, set speed 2400 
define computer set parity even, set flow xon 
define communication modem, computer 

define protocol set window 4, set rec packet-len 2000, set block 3 
define setup communication, protocol 

After you have executed these definitions, invoking the setup macro will invoke the 
communication and PROTOCOL macros. The communication macro will, in turn, in¬ 
voke the modem and COMPUTER macros. 


Macros that Define Macros 

Before proceeding, let’s stop and ask ourselves the vital question: Can we define a macro 
that defines other macros? Suppose you use C-Kermit on a PC with OS/2 to access two 
different remote computers, one of them running the VMS operating system and the other 
running UNIX. Suppose also that on each computer you switch back and forth between 
Italian and Russian text. But the two computers use different character sets for each of 
these languages. You want to have one set of macros called VMS and UNIX for switching 
between the two computer systems, and another set called ITALIAN and RUSSIAN for 
switching between the two languages appropriately for each machine. To illustrate how to 
construct macros that define macros, let’s make the VMS and UNIX macros each define 
their own appropriate Italian and RUSSIAN macros. But first we must solve a small syn¬ 
tax problem. In the command: 

def unix def italian set xfer char latinl, set file char italian 

which macro, UNIX or ITALIAN, does the SET file char Italian command belong to? We 
need a way of grouping commands inside a macro definition so Kermit can tell which 
definition the commands belong to. For this, we use curly braces. First, the VMS macro: 

define vms - 

set parity none, - 

set terminal display 8, - 

define italian { - 

set terminal character-set dec-mcs, - 
set file character-set cp850, - 
set transfer character-set latinl - 
}, - 

define russian { - 

set terminal character-set koi8 cp866, - 

set file character-set cp866, - 

set transfer character-set cyrillic - 

> 

When you execute the VMS macro, it sets the parity and terminal display parameters im¬ 
mediately and defines Italian and Russian macros for later use. The curly braces tell 
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Kermit which commands are part of the VMS macro and which ones are part of the 
ITALIAN and RUSSIAN macros. Now here is the UNIX macro: 


define unix - 

set parity even, - 

set terminal display 7, - 

define italian { - 

set terminal character-set italian, - 
set file character-set cp850, - 
set transfer character-set latinl - 
}, - 

define russian { - 

set terminal character-set short-koi cp866, - 

set file character-set cp866, - 

set transfer character-set cyrillic - 

} 

First you invoke the VMS or UNIX macro to tell which kind of system you’re talking to. 
Then you can invoke the ITALIAN or RUSSIAN to set up the proper character sets for the 
given language on the computer you are using. 


The On_Exit Macro 

Just as C-Kermit has an initialization file for commands that you want executed every 
time Kermit starts, it also has a way to execute commands of your choice automatically 
when it exits. If you have defined a macro called on_exit, Kermit executes it when you 
give the EXIT or QUIT command, just before it does its final acts of cleaning up and self 
destruction. The ON_EXIT macro should be defined in your C-Kermit initialization file. 
Here’s a sample that can be used by someone who always uses C-Kermit to dial out: 

define on_exit hangup, echo Remember to turn off your modeml 
To illustrate its use: 

$ kermit (Start Kermit) 

(Transfer some files, etc...) 

C-Kermit> exit (EXIT hangs up the phone) 

Remember to turn off your modeml (and prints a reminder) 

$ 

Macros versus Command Files 

Command files and macros can be mixed in every conceivable way. Macros can be (and 
typically are) DEFlNEd in command files, macros can be invoked from command files, 
command files can be TAKEn from inside a macro, a macro can define another macro, and 
so on. What are the differences between command files and macros? 

• A command file can be any length at all, whereas a macro definition is restricted to the 
length of C-Kermit’s command buffer, which is about 1000 characters. 
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• Macros, once defined, are available at all times while C-Kermit is running and can 
be invoked simply by name, regardless of C-Kermit’s current directory, whereas the 
command for invoking a command file changes when C-Kermit’s default directory 
changes. 

• Macro execution is faster, because C-Kermit executes macros out of its own memory 
rather than by opening and reading a disk file. 

• You can define all your macros in a single command file, which usually is preferable 
to cluttering up your disk with lots of command files. 

• Most importantly, macros can have arguments. 

Macro Arguments 

You can furnish a macro with additional information in the form of operands, or 
arguments, by including them after the macro name when you invoke it and separating 
each argument by whitespace (one or more spaces or tabs). You can think of a macro as a 
verb to which you can give different objects, like “eat spaghetti,” “eat com,” “eat salad.” 
Eating is a routine operation, but it can be performed on a variety of foods. 

C-Kermit> define eat echo Thank you for the \%1. It tastes good. 
C-Kermit> eat bread 

Thank you for the bread. It tastes good. 

C-Kermit> eat calzone 

Thank you for the calzone. It tastes good. 

C-Kermit> 

The arguments are real data—-words, numbers, filenames, and so on—that are plugged 
into special place-holders in the macro definition (\%1 in the previous example) before the 
commands in the macro are executed. 

Here is a more complete, formal, and precise description of macro invocation: 

[DO] macro-name [ argl [ argl [ ... [ arg9 7777 

Sets the variable \%0 to the name of the macro. Copies the text of the arguments into 
the variables \%1,\%2, ...,\%9. Sets the variable \v( argc ) (explained later in 
this chapter) to the number of arguments plus 1, and then executes the commands 
defined for the named macro, substituting any occurrences of these variable names in 
the macro definition with the values just assigned. 

Let’s try that again in English. When you invoke a macro, you can also type some other 
stuff—up to nine words—after the macro’s name. Each word is assigned to a variable 
that has a funny-looking name: backslash-percent-digit. For example: \%2. The digit 
tells the position of the word in the command you just typed: 0 for the name of the macro 
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itself, 1 for the first word after its name (the first argument), 2 for the second word, and so 
on. If there are more than 9 words, the extra words are ignored. If there are fewer than 9 
words, the extra variables are given a null (empty) value. Argument variable names (\%0, 
\%1, etc.) that occur anywhere in your macro definition are replaced by the assigned 
values when the commands in the macro are executed. 

Maybe another example will help. Here is a macro definition that adds a COPY command 
to the UNIX version of C-Kermit: 

C-Kermit >define copy run cp \%1 \%2 

(for VMS or OS/2, just change cp to copy). 32 Invoke this macro by typing its name, fol¬ 
lowed by the name of the file you want to copy and the name of the file you want to copy 
it to: 

C-Kermit >copy oofa.old oofa.new 

When the macro is executed, \%1 is replaced by oofa.old and \%2 is replaced by 
oof a. new, so the command that Kermit actually executes is: 

run cp oofa.old oofa.new 

Kermit’s argument-passing scheme should be crystal clear to you now—so clear that you 
put this book down between the last paragraph and this one, ran to your terminal, added 
even more new commands, and then translated all of Kermit’s built-in commands into 
Hungarian simply by defining macros for them. If you didn’t do all that, go do it now. 

Format of Macro Arguments 

A macro argument is a string of characters surrounded by whitespace (spaces or tabs). 
The final macro argument can be either the final string of non-whitespace characters on 
the command line, or it can be followed by a trailing comment, which is ignored. To il¬ 
lustrate, we define a macro, arglist, that prints its first four arguments, and then we in¬ 
voke it in various ways: 

C-Kermit >def arqlist echo 1=(\%1) 2= <\%2) 3=(\%3) 4=(\%4) 
C-Kermit >arqlist amethyst blue red yellow green 
l=(amethyst) 2=(blue) 3=(red) 4=(yellow) 

C-Kermit >arglist one two 
1=(one) 2=(two) 3=() 4=() 

C-Kermit> arqlist one two ; with a comment 
1=(one) 2=(two) 3=() 4=() 

C-Kermit> 


32 This example does not apply to AOS/VS, whose copy command reverses the order of the filenames. 
We’ll see how to cope with that problem in the next chapter. 
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If you want an argument to include spaces, enclose it in curly braces: 

C-Kermit> arglist {this one has four words} abc xyz 
l=(this one has four words) 2=(abc) 3=(xyz) 4=() 

As you can see, the braces are removed. If you want the braces kept, use two pair: 

C-Kermit >arqlist {{abc def>) xyz 
l=({abc def>) 2=(xyz) 3=() 4=() 

The command SHOW ARGUMENTS, given inside a macro, displays the macro’s arguments: 

C-Kermit >define shoarqs show arguments 
C-Kermit> shoarqs one two (three and} four 
Macro arguments at level 0 
\%0 = shoargs 
\%1 = one 
\%2 = two 
\%3 = three and 
\%4 = four 
C-Kermit> 


Scope of Macro Arguments 

The argument variables \%0 through \%9 are created when the macro is invoked and are 
available to the macro throughout its execution. Arguments that are not specified are set 
to null (empty) values, as shown in the previous examples. 


If macro A invokes macro B, macro B gets a whole new set of arguments \%0 through 
\%9, and it does not have access to macro A’s arguments at all. When macro B ter¬ 
minates, macro A still has its own original copies of these variables. This process is repli¬ 
cated as deeply as macro invocations can be nested. To illustrate: 


C-Kermit> def top show arg, middle Testing, show arg 
C-Kermit> def middle show arq, bottom XXX, show arg 


C-Kermit> def bottom show arg 

C-Kermit> top Hello 

Macro arguments at level 0 
\%0 = top 
\%1 = Hello 

Macro arguments at level 1 
\%0 = middle 
\%1 = Testing 

Macro arguments at level 2 
\%0 = bottom 
\%1 = XXX 

Macro arguments at level 1 
\%0 = middle 
\%1 = Testing 

Macro arguments at level 0 
\%0 = top 
\%1 = Hello 

C-Kermit> 


(Invoke TOP macro with arg "Hello") 
(Now we're in the TOP macro) 

(TOP macro shows its arguments) 
(This is what I typed) 

(TOP macro invokes MIDDLE macro) 
(MIDDLE macro shows its name) 

(and its argument) 

(MIDDLE invokes BOTTOM) 

(BOTTOM macro shows its name) 

(and its argument) 

(Now back to MIDDLE macro) 

(Its name is still the same) 

(and so is its argument) 

(Now back to TOP macro) 

(Its name is still the same) 

(and its argument is too) 
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If a macro definition happens to include a take command, the macro’s arguments are 
available to the command file too. To illustrate, suppose the file HAYES.TAK contains: 

set modem hayes ; Specify modem type 

set line /dev/cua ; Specify communication device 

set speed 2400 ; Set the speed 

dial \%1 

Also suppose you define the following macro and then invoke it: 

C-Kermit> define hayes take hayes.tak 
C-Kermit> hayes 7654321 

C-Kermit executes the commands in the HAYES macro, replacing all the backslash-percent 
variables by the macro’s actual arguments. Because the hayes macro is still active while 
the command file is being executed, the \ % 1 variable is available in the command file too, 
and the hayes.tak command: 

dial \%1 

becomes: 

dial 7654321 

before C-Kermit executes it. 


A Macro Sampler 


To bring the concepts of macros and arguments down to earth, here is a brief sampling of 
connection and file-transfer macros that real C-Kermit users actually use in everyday life. 


Dialing Macros 

Suppose that whenever you dial out, you always use a particular modem on a certain 
device. Here is a macro called MYDLAL that issues all the needed SET commands, dials 
your number, and puts you in connect mode if the call is completed successfully. Put 


these commands in your C-Kermit imtiali 
device name, and speed. 

; MYDIAL - All the steps needed 
define mydial - 

set macro error on,- 
set modem hayes,- 
set line /dev/cua,- 
set speed 2400,- 
dial \%1,- 
connect,- 

set macro error off 


file, substituting your own modem type, 


for dialing out in one command. 

Quit on failure 
Modem type 
Device name 
Speed 

Dial the number 

Only if the call is completed 

Back to normal 


You can use this macro to call any number at all: 

C-Kermit> mydial 765-4321 ; A phone number 

C-Kermit> mydial 1-800-555-555 ; Another phone number 
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Here are sample macros that use MYDIAL to call specific numbers (the numbers shown are 
fictitious, except the last one). 

define CompuServe mydial 7654321 
define mcimail mydial 8765432 
define dowjones mydial 9876543 
define decstore mydial 1-800-234-1998 

(You can also use names from your dialing directory in place of actual phone numbers.) 
You can use these macros to call a host or service by typing just the macro name at the 
C-Kermit prompt. You can even abbreviate the name: 

C-Kermit> mci 

Adapt the macros in this section to your own setup and the hosts or services that you use 
and put their definitions in your C-Kermit initialization file. Then let Kermit’s fingers do 
the walking! 

Network Macros 

If you’re a network user, you can add similar macros for the network connections you 
commonly make to your C-Kermit initialization file. Here are macros to make the ap¬ 
propriate settings for TCP/IP and X.25 networks. 

define tcp - 

set net tcp/ip, set flow none, set parity none, - 
set receive packet-length 2000, set window 4, - 
telnet \%1 

define x25 - 

set net x.25, set flow xon/xoff, set parity mark, - 
set receive packet-length 250, set window 8, - 
set host \%1, if success connect 

IF SUCCESS is explained in the next chapter. The communications and file transfer 
parameters are samples only, and not necessarily optimal for all connections. 

And here are macros to make the desired connections just by typing their names (host 
names and numbers are fictitious): 

define chemvax tcp vax.chem.xxx.edu 
define catalog tcp library.xxx.edu 
define mcimail x25 1234567890 

File Transfer Macros 

Finally, here are two macros for selecting and initiating text or binary mode file transfer: 

define bsend set file type binary, send \%1 \%2 
define tsend set file type text, send \%1 \%2 

The second argument, \% 2, is the name the file is to be sent under. If the second argument 
is omitted, the file is sent under its own name. 
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Variables 


Variables are things that stand for other things. At different times, the same variable 
might take on different values. Its value can vary, which is why it’s called a variable, but 
its name always stays the same. Macro arguments are one type of C-Kermit variable, ac¬ 
cessible only to the macro they were given to. This section describes several other kinds 
of variables, which, unlike macro arguments, are global, meaning they are accessible to all 
commands at all levels: at the C-Kermit prompt, in command files, and in macros, no mat¬ 
ter how deeply nested. 


Global Variables 

Global variable names are like macro argument names, but spelled with unaccented 
Roman letters instead of digits: \%a, \%b, \%c, ..., \%z. The case of the letter doesn’t 
matter; \%a is the same variable as \%A, so there are 26 global variables available for your 
use. All of these variables have the null (empty) value until a value is given to them with 
the define or assign command: 

C-Kermit> define \%n Fred C. Dobbs 
C-Kermit> defin \%d 1(212)555-1212 
C-Kermit> def \%f oofa.txt 

You can find out which global variables are defined and what their values are with the 
SHOW GLOBALS command: 

C-Kermit> show glob 
Global variables: 

\%f = oofa.txt 
\%d = 1(212)555-1212 
\%n = Fred C. Dobbs 
C-Kermit> 

You can use a variable almost anywhere in any Kermit command. Simply place it where 
you want its value inserted: 

C-Kermit >echo \%n calling \%d to transfer \%f... 

Fred C. Dobbs calling 1(212)555-1212 to transfer oofa.txt... 
C-Kermit >dial \%d (dial 1(212)555-1212) 

C-Kermit> send \%f (send oofa.txt) 

C-Kermit> 

Evaluation of variables is simply a matter of text substitution. Variables do not have 
types, like numeric versus character string. They are substituted in place at the time they 
are evaluated. If the result is illegal, an error is diagnosed in the same way it would be 
you had typed the illegal value in directly. Example: 

C-Kermit> define \%x oofa (A non-numeric value) 

C-Kermit> set block-check \%x (Use it in a numeric context) 
?Invalid - set block oofa (Kermit doesn't understand) 
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C-Kermit> define \%x 2 (Try a numeric value) 

C-Kermit> set block-check \%x (Use it in the same context) 
C-Kermit> (No complaint) 

If you want to use a variable name itself literally in a command, precede its name with a 
backslash: 

C-Kermit> define \%a Hello again 

C-Kermit> echo My name is "\\%a". My value is "\%a". 

My name is "\%a". My value is "Hello again". 

C-Kermit> 

You should keep in mind one restriction on C-Kermit’s text substitution. You can’t place 
a variable that expands into multiple words in a command field that is required to be a 
single word. For example: 

C-Kermit >def \%a file type binary 
C-Kermit >set \%a 
?More fields required 
C-Kermit> 

But: 

C-Kermit> def \%b file 
C-Kermit> def \%c type 
C-Kermit> def \%d binary 
C-Kermit> set \%b \%c \%d 
C-Kermit> 

Assigning versus Defining 

Variable definitions can be nested, meaning that the definition of one variable can contain 
the names of other variables: 

C-Kermit >define \%a My name is \%b. 

C-Kermit >define \%b not \%c 
C-Kermit >define \%c Olga 
C-Kermit> echo \%a 
My name is not Olga. 

C-Kermit> 

This raises an interesting question: what happens if we define a variable in terms of itself? 

C-Kermit> define \%a 5 (\%a is defined to be "5") 

C-Kermit> define \%a -\%a (\%a defined to be ”-\%a") 

C-Kermit> echo \%a (What does this do?) 

Luckily, you’ll never know. This is called a circular definition, and would result in the 
construction of an infinitely long string of dashes in front of the 5, quickly filling up the 
computer’s memory if C-Kermit didn’t notice and put a stop to it: 

?Definition circular or too deep 
C-Kermit> 


(Define each word separately) 


(No complaint) 
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But what if all we really wanted to do was replace the definition of \%a by itself with a 
dash in front of it, for example to turn a positive number into a negative one? We need a 
way to tell C-Kermit to copy the value of the variable(s) in the definition, rather than their 
names. This capability is provided by the assign command: 

ASSIGN name [ text ] 

This command is like the DEFINE command, and, like DEFINE, can be used to create or 
give new values to either macros or variables. Unlike define, it evaluates any vari¬ 
ables in the text before making it the value of the variable or macro. Synonym: ASG. 
Example: 

C-Kermit> define \%a 5 
C-Kermit> assign \%a -\%a 
C-Kermit>echo_\%a 
-5 

C-Kermit> 

The difference between DEFINE and ASSIGN is important when the definition text contains 
backslash-prefixed items such as variable names whose values might change before they 
are used, define copies them literally, postponing their evaluation until a command ac¬ 
tually refers to them, allowing future references to pick up the new values, whereas 
ASSIGN evaluates them at the time the assignment is made, preserving their current values. 

Macros as Variables 

Macros can be used as variables too. Define a macro in the normal way, but if you intend 
to use it as a variable rather than as a list of commands, it can contain any text at all: 

C-Kermit> define phone-number 1(212)555-1212 

You can refer to it using special notation: precede its name by \m and enclose it in paren¬ 
theses. C-Kermit replaces this construction with the macro’s definition: 

C-Kermit> echo \m(phone-number) 

1(212)555-1212 

C-Kermit> dial \m(phone-number) 

A macro used in this way is exactly like a global variable, except it can have a long 
descriptive name. Obviously, you can’t execute macros whose definitions are not Kermit 
commands: 

C-Kermit> phone-number 
?Invalid: 1(212)555-1212 
C-Kermit> 

It is usually a better idea to name variables in this way than to use the global variables \%a 
through \ % z because there is less chance that they will be accidentally superseded by new 
definitions. See the standard C-Kermit initialization file, CKERMIT.INI or .kermrc, for 
examples. 


226 Command Files, Macros, and Variables / Chapter 11 



Arrays 

An array is a global variable that has a list of values, each one with its own index, a num¬ 
ber ranging from 0 to a maximum that you choose. An array name looks like a global 

variable name, except with an ampersand instead of a percent sign: \&a, \&b,_, \&z. 

As with other variable names, case doesn’t matter: \&a is the same array as \&a. The in¬ 
dex goes in square brackets appended to the name: \&a[0] is the “zeroth” element, 
\&a [ 1 ] is the first element, and so on. 


Before you can use an array, you must declare its size so Kermit can allocate memory 
for it: 

DECLARE array-name [ number ] 

Creates an array of the given name, with number + 1 elements, 0 through number. For 
example, the command: 

C-Kermit> declare \&xf2001 

creates an array named \&x that has 201 elements, numbered 0 through 200. 


Array elements, like any other variable, can be created with the DEFINE or ASSIGN com¬ 
mand. An array index can be a constant or any type of variable, including another array 
element: 


C-Kermit> dcl \&xf10231 
C-Kermit> def \&x[100] HUNDRED 
C-Kermit> def \%i 100 
C-Kermit> ech \&x[\%i] 

HUNDRED 

C-Kermit> asq \&x[991 \%i 
C-Kermit> ech \&x[\&x[9911 
HUNDRED 
C-Kermit> 


(Declare array \&x r size 1024) 
(Define 100th element of \&x) 
(Define a global variable) 

(Use it as an index) 

(Define another array element) 
(Use it as an index) 


C-Kermit arrays are one-dimensional. That is, you cannot create or use an array that has 
more than one index. A declaration for an array that already exists destroys the previous 
array, and allocates a new empty one with the same name and with the given size. A dec¬ 
laration with a size of zero destroys the array and releases its memory: 
C-Kermit >declare \&xf01 


You can find out what arrays are declared with the SHOW ARRAYS command: 

C-Kermit> sho arra 
Declared arrays: 

\&@[4 ] 

\&a[3] 

\&x[200] 

We’ll see some uses for arrays in the coming chapters. 
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The C-Kermit Argument Vector Array 

The array \&@ is special. It is created automatically when Kermit starts up, and it contains 
the program’s “argument vector”—the command you gave to start C-Kermit. For ex¬ 
ample, suppose you started C-Kermit by giving the following command at the UNIX shell 
prompt: 33 

$ kermit -1 /dev/ttya 
C-Kermit> echo \&@[0] 
kermit 

C-Kermit >echo \&@fll 
-1 

C-Kermit >echo \&8r21 

/dev/ttya 

C-Kermit> 

Kermit does not let you change the values of the \&@ array. They are read-only. 

Built-in Variables 

C-Kermit offers a selection of built-in, read-only, named variables. Read-only means that 
C-Kermit itself gives them their values. You can’t define or ASSIGN them yourself, you 
can only use the values Kermit gives them or test them with IF DEFINED. Built-in variables 
have names that look like this: 

\v(name) 

that is, a backslash, the letter v, and then the variable name in parentheses. Either upper- 
or lowercase letters can be used. C-Kermit’s built-in read-only variables include: 

\v(argc) 

The number of arguments to the current macro, including its name. Example: 

C-Kermit> define countwords echo Arguments: \v(arqc) 
C-Kermit> countwords here are some words 
Arguments: 5 
C-Kermit> 

\v(args) 

The number of “words” you typed when you invoked C-Kermit: 

$ kermit -p e -1 /dev/acu -b 2400 
C-Kermit> echo \v(arqs) 

7 

C-Kermit> 

\v(cmdlevel) 

Current command level; 0 means interactive. Anything greater than zero means 
C-Kermit is getting its commands from a command file or a macro definition. 


33 Command-line arguments are explained in Chapter 14. 
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\v(cmdfile) 

The name of the current command file, if any. If a macro is currently executing, its 
name is available as \%0. Example: 

Echo Greetings from \v(cmdfile)l 

\v(cmdsource) 

The current source of commands: PROMPT (if interactive), file (if a command file), or 
MACRO (if a macro definition). 

\v(count) 

The current set count value (explained in Chapter 12). 

\v(cpu) 

The type of CPU for which C-Kermit was built (which is not necessarily the same as 
the type of CPU on which it is running). Examples include mc68000 for the Motorola 
68000 series, i386 for the Intel 80386, spare for the Sun SPARC RISC processor, and 
so on. If not known, the value is simply “unknown”. 

\v(date) 

The current date, for example 8 Aug 1992. The month is the first three letters of the 
month’s name (your operating system might be configured to return month names in 
your local language). The date string contains imbedded spaces (see \v (ndate) for 
an alternative). Example: 

C-Kermit> echo Today is \v(date). 

Today is 8 Aug 1992. 

C-Kermit> 

\v(day) 

The day of the week, written as the first three letters of the weekday: Sun, Mon,_, 

Sat (your operating system might be configured to return day names in your local 
language). Example: 

C-Kermit> echo Today is \v(day), \v(date). 

Today is Sat, 8 Aug 1992. 

C-Kermit> 

\v(directory) 

The current (default) directory. Example: 

C-Kermit> set prompt [\v(dir)] C-Kermit> 

[/usr/olga/correspondence] C-Kermit> 

\v(exitstatus) 

The numeric return code that C-Kermit would give to your computer’s host operating 
system if you gave it the EXIT command right now. This code indicates the success or 
failure in various operations (see page 323). 
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\v(filespec) 

The file specification from your most recent file transfer. Useful for referring to the 
same group of files again for other purposes, for example: 

C-Kermit> send x*.* 

C-Kermit >echo \v(filespec) 
x*. * 

C-Kermit >remote dir \v(filespec) 

\v(fsize) 

The size of the file most recently transferred. 

\v(home) 

Your home (login) directory. For UNIX, something like /usr/olga/. For VMS, 
something like $DISK1 : [ OLGA ]. \v (home) is a portable construction suitable for 
concatenation with a filename without any intervening characters; a construction like 
\v( home) oof a. txt should work on all operating systems where C-Kermit runs. 

\v(host) 

The network host name, if any, of the computer where C-Kermit is running: 

C-Kermit >set prompt Kermit-at-\v(host)> 

Kermit-at-watsun> 

\v(inchar) 

The last character that was read by the INPUT command (explained in Chapter 13). 

\v(incount) 

The number of characters read by the most recent INPUT command (Chapter 13). 

\v(input) 

The contents of the input buffer (Chapter 13). 

\v(line) 

The current communication line or device or network host name or number (the most 
recent SET LINE or SET HOST value). 

\v(local) 

1 if Kermit is in local mode; that is, you have given a SET LINE, SET HOST, or TELNET 
command to initiate a connection from the computer where C-Kermit is running to 
another, remote computer. 0 otherwise. 

\v(ndate) 

The current date in numeric yyyymmdd format, e.g. 19920208, suitable for sorting or 
comparison with IF EQUAL, IF LLT, IF LGT (explained Chapter 12), or for making 
filenames. For example: 

C-Kermit> log transactions \v(ndate).log 
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\v(nday) 

The numeric value of the day of the week. 0 is Sunday, 1 is Monday, and so on until 
Saturday, which is 6. 

\v(ntime) 

Numeric time. The current time in seconds since midnight, local time. For example, 
10:00 p.m. would be 79200. 

\v(platform) 

The specific platform for which your version of C-Kermit was built, such as 
AT&T_System_V_R4, NeXT, etc. This is the same as the end part of C-Kermif s ver¬ 
sion herald, but with spaces replaced by underscores to allow convenient use of this 
variable in commands without introducing unwanted field delimiters. 

\v(program) 

The name of this program, C-Kermit. 

\v(return) 

The return value of the most recently called macro or user-defined function (explained 
in Chapter 12). 

\v(speed) 

The communication device transmission speed, if known. Be careful, the value 
reported is misleading if the communication device is not a true serial communication 
device. For example, most UNIX systems report the speed of a pseudoterminal device 
as 38400 bps. 

\v(status) 

Zero (0) if the previous command succeeded, nonzero if it failed. Use this variable to 
access a command’s status so you can save it for later reference. For example: 

send oofa.a 

assign \%a \v(status) 

send oofa.b 

assign \%b \v(status) 

echo Status: oofa.a \%a, oofa.b \%b. 

\v(system) 

The generic name for the host operating system or environment: UNIX, VMS, or 
OS/2. 

\v(tfsize) 

The total number of file bytes transferred in the most recent file transfer. If a group of 
files was transferred, \v (tf size) shows their total size, whereas \v (f size) 
shows the size of only the last file transferred. 

\v(time) 

The current local time in 24-hour hh: mm: s s format. Example: 15:28:00. 
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\v(ttyfd) 

(UNIX only) The file descriptor of the communication device selected in the most 
recent SET LINE or SET HOST command. Use this to construct command lines to invoke 
exterior protocols or communication programs with the RUN command, for example: 

C-Kermit> set modem microcom 
C-Kermit> set line /dev/cua 
C-Kermit> set speed 2400 
C-Kermit> dial 7654321 
C-Kermit> run xyzcom -f \v(ttyfd) 

\v(version) 

The Kermit program’s numeric version number. For example, version 5A(188) is 
501188. Use this in IF equal, if llt, if lgt statements (explained later) to construct 
scripts that can take advantage of commands in new releases of C-Kermit that aren’t 
present in old releases. 

C-Kermit’s built-in variables can be used in any context where they make sense: 

C-Kermit> echo It's \v(time) on \v(date) 

It's 17:56:04 on 11 Mar 1992 
C-Kermit> 

You can find out what built-in variables are available and their current values with the 
command show variables (this example does not show a complete list): 

C-Kermit> show var 
\v(argc) = 0 
\v(args) = 2 
\v(cmdfile) = 

\v(cmdlevel) = 0 
\v(cmdsource) = prompt 
\v(cpu) = spare 
\v(date) = 12 Jul 1992 
\v(day) = Sun 
\v(directory) = /usr/olga 
\v(home) = /usr/olga/ 

\v(host) = watsun 

\v(line) = /dev/tty 

\v(local) = 0 

\v(ndate) = 19920712 

\v(nday) = 0 

\v(ntime) = 82463 

\v(platform) = SunOS_4.1_(BSD) 

\v(program) = C-Kermit 
\v(speed) = 38400 
\v(status) = 0 
\v(system) = UNIX 
\v(time) = 22:54:24 
C-Kermit> 
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Environment Variables 

Environment variables are variables that certain computer operating systems or applica¬ 
tion environments make available to application software (such as C-Kermit) at runtime. 
An environment variable has a name and a value. C-Kermit gives you access to your 
computer’s environment variables (if it has any) with variables of the form: 

\$(name) 

that is, backslash and dollar sign followed by the name of the environment variable 
enclosed in parentheses. Which, if any, variables are available depends on your computer 
system and your own setup, which is entirely unknown to C-Kermit. Those commonly 
available on UNIX and VMS include: 

\ $ (HOME) Your home directory 

\ $ (USER) Your login username 

\ $ (TERM) Your terminal type 

Note that alphabetic case is significant in environment variable names. Example (with 
results shown for both UNIX and VMS): 

C-Kermit >echo HOME=\$(HOME), USER=\$(USER), TERM=\$(TERM) 
HOME=/usr/olga, USER=olga, TERM=vt300 
HOME=$diskl:[Olga], USER=OLGA, TERM=vt300 

In UNIX and OS/2, you can find out what environment variables are currently defined by 
issuing the command set at the shell prompt, or by using the C-Kermit command: 
C-Kermit >run set 

In UNIX, you can define an environment variable like this: 

$ MYNAME=01a f ; export MYNAME (sh or ksh) 

% setenv MYNAME Olaf (csh) 

In VMS and Open VMS, C-Kermit treats logical names as environment variables: 

C-Kermit> echo \$(SYS$SYSTEM) 

SYS$SYSROOT:[SYSEXE] 

You can find out your logical names with the VMS SHOW LOGICALS command and you 
can define new ones with the VMS DEFINE command: 

$ define MYNAME "Olaf" 

$ show logical myname 

"MYNAME" = "Olaf" (LNM$PROCESS_TABLE) 

$ kermit 

C-Kermit> echo Hello there, \$(MYNAME). 

Hello there, Olaf. 

C-Kermit> 
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Defining versus Assigning Revisited 

Some of C-Kermit’s \v() variables change depending on conditions. For example, 
\v(directory) changes whenever you give a CD command; the \v(time) variable 
changes every second, all by itself. These variables serve nicely to illustrate the distinc¬ 
tion between define and ASSIGN, in case it is still in doubt. Let’s create a variable \%a 
that includes a reference to \v(time) in its value. First with the define command, 
which copies the name of the \v(time) variable into the definition of \%a: 


C-Kermit>DEFINE \%a The time is \v(time) 


C-Kermit >show globals 
\%a = The time is \v(time) 
C-Kermit >echo \%a 
The time is 13:25:03 
C-Kermit >sleep 60 
C-Kermit> echo \%a 
The time is 13:26:03 


(Check the value of \%a) 

(Evaluate it) 

(Let one minute pass) 
(Look again) 

(See how it changed) 


And again, but with the assign command, which evaluates the \v(time) variable and 
copies its value into the \%a definition: 


C-Kermit>ASSIGN \%a The time is \v(time) 


C-Kermit >sho globals 
\%a = The time is 13:31:47 
C-Kermit> echo \%a 
The time is 13:31:47 
C-Kermit >sleep 60 
C-Kermit> echo \%a 
The time is 13:31:47 


(Check the value) 

(No \v(time)) 
(Evaluate \%a) 

(Sleep one minute) 
(Check again) 

(Time stands still!) 


So, once again, the rule is: use ASSIGN to get the current value of a variable whose value 
might change before you want to use it. Use DEFINE to ensure that whenever you refer¬ 
ence a variable, you get its latest value. When the definition text does not contain vari¬ 
ables, define and ASSIGN are equivalent. 
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Chapter 12 


Programming Commands 


Command files, macros, and variables are useful tools, but by themselves they are little 
more than conveniences. However, if they are used within the framework of a program¬ 
ming language, they can open up all sorts of new possibilities. Programming language? 
If you’re not a programmer, don’t be alarmed. The language we’re talking about is noth¬ 
ing more than the Kermit commands you are already familiar with, plus a few additional 
elements: commands for decision-making, for skipping other commands, for repeatedly 
executing groups of commands, for reading and writing file data, and for interacting 
directly with the user. 

The IF Command 


Let’s begin by introducing Kermit’s decision-making command. 

IF condition command 

If the condition is true, the command is executed. If the condition is not true, the com¬ 
mand is ignored; that is, it is treated as a comment. 

IF NOT condition command 

If the condition is not true, the command is executed. If the condition is true, the com¬ 
mand is ignored. 

The command can be any C-Kermit command, including another IF command, but not an 
ELSE command (see page 237), and it can also be a macro invocation or a TAKE command. 
It is on the same line as the IF command, and is separated from it by one or more spaces. 
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no commas or other punctuation. The condition is a statement that can be true or false, 

consisting of one to four “words” separated by spaces. Example: 

if equal "\%a" "Rumpelstiltskin” echo You guessed my name! 

The condition is: 

equal ”\%a" "Rumpelstiltskin" 

and the command is: 

echo You guessed my name! 

The following sections describe C-Kermit’s IF conditions. 


Comparing Numbers 

Let’s begin with the IF commands that compare numbers. The numbers in the following if 
conditions can be constants (literal numbers) or variables of any kind whose values are 
whole numbers, positive or negative. If these comparisons are used with nonnumeric 
values, or numbers containing decimal points, they give a syntax error message and fail. 

IF = numberl number2 command 

If numberl is equal to number2, the command is executed. Example: 

C-Kermit> define \%a 2 

C-Kermit> if = ? First number or variable name 
C-Kermit>if = \%a ? Second number or variable name 
C-Kermit>if = \%a 3 echo They are equal (Nothing happens) 

C-Kermit> if = \%a 2 echo They are equal (Condition is true) 

They are equal (Command is executed) 

C-Kermit> 

IF NOT = numberl number2 command 

If numberl is not equal to number2, the command is executed. Example: 

C-Kermit> define \%a 2 

C-Kermit> if not = \%a 2 echo Not equal 

C-Kermit> if not = \%a 3 echo Not equal 

Not equal 
C-Kermit> 

IF < numberl number2 command 

If numberl is less than number2, the command is executed. Example: 

C-Kermit> define \%a 2 

C-Kermit >if < \%a -5 echo It's less (Nothing happens) 

C-Kermit> if < \%a 100 echo It's less (Condition is true) 

It's less (Command is executed) 

C-Kermit> 


(Nothing happens) 
(Condition is true) 
(Command is executed) 
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IF NOT < number 1 number2 command 

If number 1 is not less than (is greater than or equal to) number2, the command is ex¬ 
ecuted. Example: 

C-Kermit> define \%a 2 

C-Kermit> if not < \%a 1 echo Not less (Condition is true) 
Not less (Command is executed) 

C-Kermit> if not < \%a 2 echo Not less (Nothing happens) 

C-Kermit> 

IF > numberl number2 command 

If numberl is greater than number2, the command is executed. Example: 

C-Kermit >define \%a 2 

C-Kermit> if > \%a 1 echo Greater (Condition is true) 

Greater (Command is executed) 

C-Kermit> if > \%a 2 echo Greater (Nothing happens) 

C-Kermit> 

IF NOT > numberl number2 command 

If numberl is not greater than (is less than or equal to) number2, the command is ex¬ 
ecuted. Example: 

C-Kermit> define \%a 2 

C-Kermit> if not > \%a 2 echo Not greater (Condition is true) 
Not greater (Command is executed) 

C-Kermit> if not > \%a 1 echo Not greater (Nothing happens) 
C-Kermit> 


Here is an example of using “IF<” to construct a timely greeting message: 


if < \v(ntime) 43200 def \%x morning 
if not < \v(ntime) 43200 def \%x afternoon 
if not < \v(ntime) 61200 def \%x evening 
echo Good \%xl 


(Before noon) 
(Before 5) 
(After 5) 


The ELSE Command 

The IF command can be followed on the next line by an else command: 

ELSE command 

Executes the command if the preceding command was an IF command and its con¬ 
dition was not true. 

Example: 

C-Kermit> if =12 echo 1=2 (Not true) 

C-Kermit> else echo 1 is not 2 (So ELSE is executed) 

1 is not 2 
C-Kermit> 

The else command causes an error if it is executed after any command other than IF. if 
and else are separate commands, not two parts of the same command. They are intended 
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primarily for use within command files and macros, but they can also be executed at the 
C-Kermit prompt, in which case you should not be alarmed if another prompt suddenly 
appears after the IF condition: 

C-Kermit> if =12 echo Strange... (False, nothing happens) 
C-Kermit> if =11 (True, new prompt appears) 

C-Kermit> echo As expected... (ECHO command is executed) 

As expected... 

C-Kermit> 

When the condition is true, C-Kermit prompts you for a command to be executed. If the 
condition is not true, C-Kermit treats the rest of the IF command as a comment. Here is an 
example of using IF and ELSE in a macro: 

C-Kermit >def add if = \%1 1 if = \%2 1 echo 2, else echo Too hardl 
C-Kermit >add 1 1 
2 

C-Kermit >add 2 2 
Too hardl 

The comma separating the IF and else commands is necessary because IF and else are 
separate commands. This example also shows how an AND effect can be achieved by 
combining multiple IF commands on the same line. A more structured “extended IF” 
command is presented later. 


String Comparisons 

The following commands compare character strings just as the IF =, IF <, and IF > com¬ 
mands compare numbers, and you can use NOT in these commands the same way. 

IF EQUAL string1 string2 command 

Executes the command if the two character strings are equal, meaning they are the 
same length and they contain the same characters in the same order. A string may be 
either a literal string or a variable containing a string. Examples: 

if equal \%1 secret echo You guessed the secret wordl 
if not equ \%1 secret echo Sorry, wrong again. 

If a variable is not defined, or has an empty value, a command field will be missing, 
causing a command error: 

C-Kermit> define \%1 (\%1 is undefined) 

C-Kermit> if equal \%1 ?Text required 
C-Kermit> 

To handle this situation, put string1 and string2 in identical quotes or parentheses: 

C-Kermit> define \%1 (\%1 is undefined) 

C-Kermit >if equal "\%1" "oofa" echo You guessed the secret wordl 
C-Kermit> 

If \%1 has not been defined, C-Kermit sees this as: 

if equal "oofa" echo You guessed the secret wordl 
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which makes the desired comparison, rather than as: 
if equal oofa echo You guessed the secret wordl 
which compares “secret” with “echo”. 

IF LLT stringl string2 command 

Executes the command if stringl is “lexically” less than (LLT) string2, in other 
words; if stringl would be alphabetized before string2. Example: 

if lit "\%a" "zyzzniak" echo It's less. 

IF NOT LLT means “lexically greater than or equal to.” 

IF LGT stringl string2 command 

Executes the command if stringl is lexically greater than (LGT) string2. Example: 
if lgt "\%a" "aardvark" echo It's greater. 

IF NOT LGT means “lexically less than or equal to.” 

In these commands, literal strings to be compared must not contain any spaces, or else 
C-Kermit will think the characters after the space are the beginning of the command to be 
executed. For example, the following command compares the value of the variable \%a 
with the word The and if they are equal attempts to execute the END command, probably 
not what was intended: 

if equal \%a The End echo All finished. 

You can get around this limitation by putting multiword character strings in variables: 
C-Kermit >define \%b The End 

C-Kermit> if equal \%a \%b echo All finished. 

The treatment of alphabetic case in string comparisons is governed by the command: 

SET CASE OFF 

In all C-Kermit’s string comparison and matching commands— IF and others still to 
come—treats uppercase and lowercase letters as equivalent: “A” is the same as “a”, 
“aardvark” equals “AARDVARK”, etc. 

SET CASE ON 

Treats upper- and lowercase as distinct: “A” and “a” are different characters. 

Unless you tell Kermit otherwise, alphabetic case is ignored. WARNING: caseless string 
comparisons, for example in the if equal, if llt, and IF lgt commands, work only for 
7-bit ASCII characters. For international (accented and/or non-Roman) characters, you 
must use case-sensitive comparisons. Even then, there is no guarantee that IF LLT or IF 
LGT will work correctly (but IF EQUAL will). 
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Checking for Success and Failure 

One of the most useful features of C-Kermit’s programming language is the ability to take 
different actions depending on whether a command succeeded or failed. For example, if a 
command doesn’t work as expected, you might want to print a message or try a different 
command instead of just going on to the next command. 

IF SUCCESS command 

Executes the command if the previous command succeeded. Equivalent to IF not 
FAILURE. Example: 

send oofa.txt 

if success echo The SEND command succeeded, 
else echo The SEND command failed. 

Every C-Kermit command except comment sets the SUCCESS indicator when it com¬ 
pletes. You can inquire about the success or failure of the previous command with the 
show status command: 

C-Kermit> type oofa.txt 
?File not found - oofa.txt 
C-Kermit >show status 
FAILURE 

C-Kermit> set file type binary 
C-Kermit> show status 
SUCCESS 
C-Kermit> 

IF FAILURE command 

Executes the command if the previous command failed. Equivalent to IF NOT 
SUCCESS. A command fails not only if it doesn’t work, but also if it has a syntax error. 
Synonym: IF ERROR. 


Other IF Commands 

C-Kermit’s if command also lets you check the existence and format of variables and 
files, as well as various aspects of C-Kermit’s operation. 

IF DEFINED name command 

Executes the command if name is the name of a macro, a macro argument, a global 
variable, a built-in variable, an environment variable, an invocation of a built-in func¬ 
tion, or an array element that is defined and has a non-empty value. Example: 

C-Kermit >define \%a foo (Define a variable) 

C-Kermit> if def \%a echo It's defined 
It's defined 

C-Kermit> define \%a (Undefine it) 

C-Kermit >if def \%a echo It's defined 
C-Kermit> if not def \%a echo Not defined 
Not defined 
C-Kermit> 
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IF NUMERIC name command 

Executes the command if name consists only of digits, or is a variable whose value 
consists only of digits, possibly with a leading plus or minus sign. 

IF EXIST filename command 

Executes the command if a single, regular, readable file of the given name exists, and 
it is not a directory, not a wildcard file group specification. Here’s an example in 
which we add the UNIX more command to the UNIX version of C-Kermit: 
define more - 

if exist \%1 run more \%1, - 
else echo File \%1 not found 

IF FOREGROUND command 

Executes the command if Kermit is running in the foreground; that is, if its standard 
input is coming from the keyboard and its standard output is going to the screen. 
Example: 

send oofa.txt 

if success if foreground echo Transfer succeeded. 

This command can be used to control whether messages are printed on the screen 
during execution of a command file or macro. If Kermit is running in the background, 
you probably don’t want messages interfering with your foreground work. 

IF BACKGROUND command 

Executes the command if Kermit is running in the background, and/or with its stan¬ 
dard input and/or output redirected. IF BACKGROUND is the same as IF NOT 
FOREGROUND. 

IF COUNT command 

This command is used for counted loops (explained later in this chapter). The count 
variable may be referred to only as an IF condition, whereas the variable \v (count) 
can be used anywhere. 

IF VERSION number command 

Executes the command if C-Kermit’s numeric version number is greater than or equal 
to the number given. The numeric version number is displayed by the VERSION 
command: 

C-Kermit> version 
C-Kermit 5A(188), 23 Nov 92 
Numeric: 501188 
C-Kermit> 

The IF VERSION command gives C-Kermit command files and macros independence 
from the program version. For example, suppose a future release of C-Kermit—say, 
502200—has a new command SET BLOCK-CHECK 6 (the current release does not). If 
you guard new commands within IF version statements, older releases of C-Kermit 
will not attempt to execute them: 
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if version 502200 set block-check 6, 
else set block-check 3 

This would let the same macro or command file run on both newer and older versions 
of C-Kermit and select the highest available block check type. You can refer to 
C-Kermit’s numeric version number in other contexts with the built-in variable 
\v(version): 

if not < \v(version) 502200 set block-check 6 
else echo No block-check 6 in version \v(version). 


An EDIT Macro 

Now we have all the tools we need to construct a somewhat smarter macro, one that is 
both useful and friendly. The macro is called edit, and it lets you edit a file directly from 
C-Kermit command level, returning you to the C-Kermit prompt when you are finished 
editing. 34 The first time you use the edit macro, you must furnish the name of a file to 
edit. The next time, if you leave out the filename, the macro will use the same name as 
before. If you supply a new filename, the macro will use that one instead of the old one. 

define myeditor emacs (Name of my editor) 

define myfile (No edit file specified yet) 

define edit - (Define the EDIT macro) 

if = \v(argc) 2 assign myfile \%1,- 
if not defined myfile echo Edit what?,- 
else run \m(myeditor) \m(myfile) 

What’s happening here? First we defined a macro, myeditor, to be the name of the system 
command that starts our favorite editor. If yours isn’t EMACS, replace the word emacs 
with whatever you want. Then we ensured that the macro, myfile, starts out with no 
definition. 

The next command (continued on several lines) defines the edit macro itself. If the ar¬ 
gument count \v(argc) is exactly 2—the macro name itself plus one argument—the ar¬ 
gument \%1 is taken as the name of a file to edit, and the value of this variable is assigned 
to the macro, MYFILE, which will hold our filename even after the EDIT macro completes. 
Next, we check to see if the MYFILE variable is defined. If it isn’t, the user must have 
typed edit without giving the name of a file to edit and had not specified a file name in an 
earlier EDIT command. So we just print a message and quit. But if MYFILE is defined, we 
execute the else command, which runs our chosen editor on the file. Examples: 

$ kermit (Start Kermit) 

C-Kermit>edit (No previous filename) 

Edit what? (Error message) 

C-Kermit>edit oofa.txt 


34 You will find a somewhat more sophisticated version of the edit macro in the distributed sample files. 
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(oofa.txt is edited...) 

C-Kermit >edit (No filename given) 

(oofa.txt is edited, EDIT macro remembers last filename...) 
C-Kermit> 

Notice that we did not use IF EXIST to check if the argument was a real file. That was on 
purpose, to allow the edit command to create new files. 

The STOP and END Commands 


Macros and command files are normally terminated after C-Kermit reads and executes 
their final command, or if they contain an EXIT command, or if an error occurs and you 
have SET MACRO error ON or set take error ON. There are also two other ways to ex¬ 
plicitly terminate a macro or command file prematurely: 

STOP [ number [ text ] ] 

This command returns you to the C-Kermit command prompt immediately from any 
level of command file or macro execution, no matter how deeply nested. When given 
at the C-Kermit prompt, the STOP command has no effect. If C-Kermit is not running 
interactively, the STOP command halts the program entirely. If a number is given, it is 
used as a return code. If text is also given, it is printed on the screen. For example, 
here is a command file called TESTSTOP.TAK: 
echo Testing the STOP command... 

stop 1 This is an error message from the STOP command, 
echo You shouldn't see this. 

Now we execute it: 

C-Kermit> take teststop.tak 
Testing the STOP command... 

This is an error message from the STOP command. 

C-Kermit >show status 
FAILURE 
C-Kermit> 

END [ number [ text ] ] 

This command causes C-Kermit to return immediately to the command level from 
which the current command file or macro was invoked. The optional number is a 
return code, and the optional text is a message to be printed. 

The default number is 0 (for success) for both commands. The text message cannot be 
printed unless a number is included before it. 

The return code lets a macro or command file declare whether it succeeded or failed. For 
example, suppose you have defined a macro called sendlotsafiles and you invoke it 
from inside a command file: 
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C-Kermit> take daily.tak 


DAILY.TAK 



sendlotsafiles 

if success echo Macro succeeded. 

The message will always appear, even if the macro failed, because the (implied) DO com¬ 
mand itself succeeded. DO or TAKE commands only fail when the given macro or com¬ 
mand file can’t be found. To make the macro pass along a failure code, use the END or 
STOP command with a nonzero return code, as in this macro definition: 

define sendlotsafiles - 
send oofa.txt, - 

if failure end 1 Can't send oofa.txt, - 
set file type binary, - 
send oofa.exe, - 

if fail end 1 Can't send oofa.exe,- 
else end 0 

To illustrate the difference between STOP and END, suppose we have a command file 
called DAILY. TAK, which we run every day. This command file performs its daily tasks 
and then checks (using \v(day) or \v(nday)) to see if it is Friday. If so, it TAKES 
another command file, WEEKLY .TAK, which in turn checks to see if it is the first week of 
the month, 35 and if so takes monthly . tak. So our command files are nested 3 deep. 
Now suppose MONTHLY. TAK encountered an error and could not continue. If it gives the 
end command, weekly.tak will resume executing after its take monthly.tak com¬ 
mand. If MONTHLY.TAK gives the STOP command, C-Kermit will cancel all the command 
files and return to its prompt, as shown in Figure 12-1. 


35 By extracting the day of the month from \v(date) or \v(ndate). We’ll learn about substrings later 
in this chapter. 
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A Helpful COPY Macro 

Remember our earlier COPY macro from page 220? 
define copy run cp \%1 \%2 

It was so easy to write, it seems a shame to complicate it. Nevertheless, much can go 
wrong with our original version. In the first place, it isn’t portable. The ideal C-Kermit 
COPY macro should work on every computer that C-Kermit runs on: UNIX, VMS, 
Open VMS, OS/2, AOS/VS, and so on. These systems can have different names for their 
copy commands (UNIX calls it cp, the others call it copy), and the filenames might be 
given in a different order (AOS/VS puts the destination file first, then the source; the 
others have the source file first, then the destination). So let’s make a new copy macro, 
incorporating what we have learned about decision making and built-in variables. It has 
the following form, no matter where it runs: 

COPY filename1 filename2 

The COPY macro makes a copy of the file whose name is filename 1, which must exist 
and must be a single, readable file. The copy is a new file called filename2. If a file 
called filename2 already exists, the COPY macro fails. 


Here is our new COPY macro. Study it as a not totally serious example of compulsive 
verification of user input. Informative error messages are issued for every conceivable 
condition where the copy operation could fail. 


define COPY - 

if > \v(argc) 3 - 

end 1 \%0: too many arguments,- 
if not def \%1 - 
end 1 copy what?,- 
if not exist \%1 - 

end 1 file "\%1" doesn't exist,- 
if not def \%2 - 

end 1 copy \%1 to what?,- 
if not = \ffiles(\%2) 0 - 

end 1 file \%2 already exists,- 
if equal "\v(system)" "AOS/VS" - 
run COPY \%2 \%1,- 
else if equal ”\v(system)" "UNIX" - 
run cp \%1 \%2,- 
else run COPY \%1 \%2,- 
if exist \%2 end 0 \%1 copied OK,- 
else end 1 COPY failed. 


Too many arguments given? 

Too many, fail. 

Was a source file given? 

No, nothing to copy. 

Does source file exist? 

No, it can't be copied. 
Destination file given? 

No, it can't be created. 
Does it already exist? 

Yes, don't write over it. 
For AOS/VS: 

COPY dest source 
COPY command for UNIX: 

cp source dest 
Others: COPY source dest 
Check work, return SUCCESS 
or FAILURE. 


Install this macro, run it with every imaginable type and combination of improper ar¬ 
guments, and see if it lets you get away with anything. 
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The GOTO Command 


So far we’ve used the decision-making capability of the IF statement in a very limited 
way: to execute or not execute a single command. In more general cases, we would like 
to decide whether to execute whole groups of commands. There are two ways to do this. 
The way you know already is to group statements in macros or command files, because 
DO and TAKE count as single commands. Examples: 

if equal \%a yes do something ; "something" is a macro name 
else take something.tak ; "something.tak" is a command file 

The new way is the GOTO command. It changes the order in which Kermit executes com¬ 
mands in a command file or a macro: 

GOTO label-name 

In a command file or a macro, go immediately to the first command after the first oc¬ 
currence of the label in the current macro or command file and begin executing com¬ 
mands at that point. If the label is not found, return to the previous level (macro or 
command file) and look there. Repeat this process until the label is found or the 
search fails. If the label is never found, C-Kermit returns to its prompt and issues an 
error message. In case of duplicate labels within a command file or macro, Kermit 
uses the first one. 

The GOTO command has no effect as an interactive command. And when piped into 
C-Kermit’s command processor from standard input, it does nothing except issue an error 
message: 

C-Kermit> qoto sleep 

?Sorry, GOTO only works in a command file or macro 
C-Kermit> 


A label is a character string of your choosing. It must begin with a colon (:), and it must 
be on a line by itself (but it can have a trailing comment). Here is an example of a com¬ 
mand file that uses GOTO commands and labels: 

send oofa.txt 

if failure goto bad 

echo oofa.txt was sent ok. 

echo Deleting oofa.txt 

delete oofa.txt 

goto done 

:bad 

echo oofa.txt was not sent, 
echo Keeping oofa.txt. 

:done 

echo Finished. 

In this example, bad and done are labels. If the file is sent successfully, it is deleted and 
the messages in the BAD section are skipped. If the file was not sent, it is not deleted and 
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the messages in the BAD section are displayed. In both cases, the “Finished” message is 
displayed. Here is the same example converted to a macro that takes the filename as an 
argument: 

define mysend send \%1,- 
if failure goto bad, 
echo \%1 was sent ok.,- 
echo Deleting \%1, delete \%1,- 
goto done,- 
:bad,- 

echo \%1 was not sent., echo Keeping \%1.,- 
:done,- 

echo Finished. 

You can use the mysend macro to send and delete any file: 

C-Kermit> mysend oofa.txt 
C-Kermit> mysend ckermit.ini 

The label-name by which the GOTO command refers to the label should be the same as the 
label, except that the colon can be omitted. Alphabetic case is always ignored when 
searching for labels. The following GOTO statements are all equivalent, meaning they all 
look for the same label, BEGIN: 

goto begin 
GoTo :begin 
GOTO :BEGIN 

GOTO label references can be variables. This lets you execute different groups of com¬ 
mands depending on the value of a variable: 

define spellnum if not def \%1 end,- 

else if not numeric \%1 end 1 { Sorry, not a number),- 

else if > \%1 9 end 1 { Sorry, too hard},- 

else if < \%1 0 end 1 { Sorry, I can't spell negative numbers),- 

else goto \%1,- 
:0,echo zero,end,- 
:l,echo one,end,- 
:2,echo two,end,- 
:3,echo three,end,- 
:4,echo four,end,- 
:5,echo five,end,- 
:6,echo six,end,- 
:7,echo seven,end,- 
:8,echo eight,end,- 
:9,echo nine,end 

Execute this definition and then: 

C-Kermit> spellnum 0 
zero 

C-Kermit> spellnum 8 
eight 

and so on. 
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Finally, here is an example that shows how Kermit peels back macro invocation levels to 
find the GOTO label: 

define first sloop, echo \%0, do second 
define second echo \%0, do third 
define third echo \%0, goto loop 
do first 

If you put these commands into a command file and then take it, you will soon see that it 
repeats forever: first, second, third, first, second, third, first, and so on. This is called a 
loop. Programmers call loops that go on forever infinite loops. You can terminate this in¬ 
finite loop by typing Ctrl-C. But a way is also needed to terminate loops automatically, 
without human intervention. 

Counted Loops 

A somewhat more practical use of the GOTO command lets you repeat selected portions of 
a command file or macro a specified number of times. Before you can do this, you must 
have a counting mechanism. C-Kermit offers several of these. The simplest one is the 
SET count / if count construction: 

SET COUNT number 

Sets the variable called COUNT to the given number, which must be greater than zero, 
for example: 

C-Kermit >set count 5 
IF COUNT command 

Subtracts one from the COUNT variable. If the new value of COUNT is greater than 
zero, the command is executed. 

The SET COUNT and IF COUNT commands can be combined with the GOTO command to 
form a counted loop: 

set count 10 
: loop 

echo \v(count) 
if count goto loop 
echo Zero! 

If you put these commands in a command file and TAKE the file, they print “ 10, 9, 8, 7, 6, 
5, 4, 3, 2, 1, Zero!” You can do the same thing in a macro: 

def count - 

set count 10,:loop,echo \v(count),if count goto loop,echo Zero! 

The COUNT “variable” is usable only as the condition of an IF statement. In other con¬ 
texts, use the \v(count) variable, as shown. Referring to the \v(count) variable does 
not change its value; only IF COUNT can do that. 
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Structured Programming 


The SET COUNT / IF COUNT / GOTO mechanism is easy to use, but programming purists may 
prefer a more structured approach. C-Kermit offers three structured programming con¬ 
structs, the XIF (extended IF) command, the FOR loop, and the WHILE loop. Each of these 
allows groups of statements to be executed conditionally or repeatedly without the use of 
labels and GOTOs. 

XIF condition { command [, command...] } [ ELSE { command [, command...]} ] 

If the condition is true, execute the command or commands enclosed in the first set of 
curly braces. If an ELSE-part is provided, and the condition is not true, execute the 
commands inside the second set of curly braces. The conditions are the same as for 
the regular if command. Examples: 

xif not exist oofa.txt { echo no oofa.txt!, stop } - 
else { send oofa.txt, echo oofa.txt sent ok. > 
xif < \%a \%b { echo \%a } else { echo \%b > 

The differences between the xif and IF commands are summarized in Table 12-1. 

FOR variable initial final increment >{ command [, command...] } 

Repeats the commands that are enclosed in braces a certain number of times. The 
initial value is assigned to the variable. If the value is not greater than the final value, 
the commands are executed. Then the increment is added to the variable and the 
process is repeated until the variable finally exceeds the final value. The number of 
times the commands are executed is: 

final - initial 

n = J -+ 1 

increment 

If n is zero or less, the commands are not executed at all. 


Table 12-1 Comparison of IF and XIF Commands 


Feature 

IF Command 

XIF Command 

Braces 

Not allowed. Example: 

IF = \%a 1 echo Equal 

Required. Example: 

XIF = \%a 1 { echo Equal } 

ELSE Part 

Separate Command, optional. 

IF = \%a 1 echo Equal 
ELSE echo Not equal 

Part of XIF Command, optional. 

XIF = \%a 1 { echo Equal > - 
ELSE { echo Not Equal } 

Object 

Only one allowed. 

Multiple commands allowed. 

Commands 

IF = \%a 1 echo Equal 
ELSE echo Not Equal 

XIF = \%a 1 { echo Equal, - 
goto xxx - 
} ELSE { - 

echo Not Equal, stop } 
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Here are some examples of FOR loops: 

for \%i 1 5 1 { echo hello > ; Prints "hello" five times 

You can read this as, “Counting from one to five by ones, echo the word hello.” 

for \%j 2 10 2 { echo \%j > ; Counts to ten by twos 

Meaning: “Counting from 2 to 10 by twos, echo the counter.” It prints 2,4,6,8, and 10. 

for \%k 10 0 -1 { echo \%k > ; Counts backwards 

This one means “Counting backwards from 10 to 0 by -1, print the counter.” It prints 10, 
9, 8, ... 0. 

Here’s an example in which we have an array \&f [ ] containing the names of files to be 
sent and then deleted. There are \%n filenames in the array. A file is deleted only if it is 
sent successfully. 

for \%i 1 \%n 1 { send \&f[\%i], if success delete \&f[\%i] } 

Finally, here is a loop that prints the C-Kermit program’s command line from the ar¬ 
gument vector array, \&@[ ]. The size of the argument vector array is given by the 
\v (args) built-in variable: 

for \%k 0 \v(args) 1 { echo \\&@[\%k] = ”\&§[\%k]” } 

The last two examples show how to use a variable to index the elements of an array. The 
value of the loop variable changes with each trip through the loop, thus accessing the next 
array element. 

The WHILE Command 

The set COUNT / if count and FOR-loop constructions let you execute groups of com¬ 
mands a certain number of times. But it is also sometimes desirable to loop based on 
some other criterion, such as a certain condition being satisfied. The WHILE command 
serves this need: 

WHILE condition { command [, command ... ] } 

Executes the commands as long as the condition is true. 

Here is an example of a “polling loop” that periodically checks the time of day until a cer¬ 
tain time is reached: 

while not lgt \v(time) 23:59;59 { echo \v(time), pause 3600 } 
while not lgt \v(time) 07:30:00 { echo \v(time), pause 60 } 
dial 87654321 
hangup 

This example gives you a wakeup call at 7:30 a.m. Start it up when you leave work; it 
checks the time every hour until midnight, then it checks the time every minute until 7:30 
a.m. arrives, then it calls your phone number. 
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In an xif, FOR, or WHILE command, the part within the braces is called the object com¬ 
mand list. In case you’re curious, the xif, FOR, and while commands are implemented as 
Kermit macros (SHOW MACROS will display their definitions—don’t try to understand 
them or you’ll get a headache). The object command list is the single macro argument 
(now you know why it’s enclosed in braces). 

Altering Loop Execution 

The following commands let you exit from for or while loops early, or skip parts of 
them and continue execution: 

BREAK 

Exits immediately from a for or while loop. The following example tries to send a 
file until it succeeds, or until it fails 10 times in row, whichever comes first: 
for \%i 1 10 1 { send oofa.txt, if success break } 

If loops are nested, break exits from the innermost enclosing loop, break is an il¬ 
legal command if it is executed outside a FOR or WHILE loop. 

CONTINUE 

Causes the next cycle of the enclosing FOR or while loop to begin immediately, skip¬ 
ping any commands between the CONTINUE command and the end of the loop. Here’s 
an example in which the array \&f[50] contains names of files, some of which might 
exist, others might not. This loop transfers the files that exist: 

for \%i 1 50 1 { if not exist \&f[\%i] continue, send \&f[\%i] } 
Like BREAK, CONTINUE is illegal outside of a FOR or WHILE command. 

Structured Programming Examples 

FOR and while loops can contain many commands and they can be nested. This example, 
written on multiple lines and indented for neatness and comprehensibility (???), sorts the 
array \&x, which has \%n text elements, using the “Programming 101” bubble sort 
algorithm. Pay careful attention to the use of commas, braces, and hyphens (and recall 
that ASG is our tasteful abbreviation for ASSIGN). 

for %i 1 \feval(\%n-l) 1 { - 
for %j \%i \%n 1 { - 

xif lgt \&x[\%i] \&x[\%j] { 
asg \%t \&x[\%i], - 
asg \&x[\%i] \&x[\%j], - 
asg \&x[\%j] \%t - 
} - 
} - 

} 

\feval() is a built-in function for evaluating arithmetic expressions, explained on page 
257. Here it subtracts 1 from the value \%n. 


Outer loop: i from 1 to n-1 
Inner loop; j from i to n 
Compare array elements 
If out of order, 
exchange them 
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Finally, here is a truly silly example of a macro 
to find the smallest of its three arguments: 


def smallest xif < \%1 \%2 {- 
echo \%1 is less than \%2,- 
xif < \%1 \%3 {- 

echo \%1 is less than \%3,- 
def \%a \%1- 

> else {- 

echo \%1 is not less than \%3,- 
def \%a \%3- 

}- 

} else {- 

echo \%1 is not less than \%2 f - 
xif < \%2 \%3 {- 

echo \%2 is less than \%3,- 
def \%a \%2- 

> else {- 

echo \%2 is not less than \%3,- 
def \%a \%3- 

>- 

>, echo So the smallest is \%a. 


that uses a nested, multipart xif command 


; Compare first two arguments 
; The first one is smaller 
; Compare it with the third 
; The first one is smaller 
; Copy it to \%a 
; The third is smaller 

; Copy it to \%a 

; Otherwise 

; The second is smaller 
; Compare it with the third 
; The second is smaller 
; Copy it to \%a 
; The third is smaller 

; Copy it to \%a 

; Announce the winner 


If you have stored this macro definition in a file called smallest. tak, you can issue a 
TAKE command to read the definition, and then you can try it out: 

C-Kermit >take smallest.tak (This defines the macro) 

C-Kermit> smallest 649 (Try it) 

6 is not less than 4 
4 is less than 9 
So the smallest is 4. 

C-Kermit> 


C-Kermit’s structured programming constructs are intended for use within command files 
or macros, and are not very handy to type interactively, but you can do it if you want to. 
You will find that question-mark help does not work on object commands, because they 
are just text passed as arguments to macros. 


Built-in Functions 


You’re almost a full-fledged Kermit programmer. You have mastered decision making, 
GOTOs, loops, and structured programming. Next comes the function call. All program¬ 
ming languages offer a variety of built-in functions to perform operations on numbers or 
character strings, and C-Kermit’s language is no exception. 

A function is a kind of “black box” into which you place some information, and which 
returns a result based on that information. The items you give to the function are called 
the function arguments. There can be zero, one, two, or more arguments, but there is only 
one result. 
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C-Kermit’s built-in functions have names that look like this: 

\f name() 

That is, backslash, the letter F, the name of the function, and then a pair of parentheses to 
hold its arguments. The F and the name can be upper- or lowercase. The name can be ab¬ 
breviated to any length that distinguishes it from other built-in function names. The 
arguments are separated by commas. For example, in: 

\fmax(\%a,100) 

there are two arguments, \%a and 100. The function reference is replaced by its result. In 
this example, \fmax() is a function that returns the larger of its two arguments, which 
must be numeric: 

C-Kermit >define \%a 333 

C-Kermit> echo The maximum of \%a and 100 is \fmax(\%a,100). 

The maximum of 333 and 100 is 333. 

C-Kermit> 

If the function call is illegal in any way, its result is null (empty): 

C-Kermit> define \%a oofa 

C-Kermit> echo The maximum of \%a and 333 is "\fmax(\%a,333)". 

The maximum of oofa and 333 is 
C-Kermit> 

Function arguments can be literal strings of characters, variable names, macro arguments, 
array elements, backslash codes, invocations of other functions, or any combination of 
these, but they are legal only if they represent the type of data required for the particular 
function argument. The result is always a character string. 

C-Kermit has functions that operate on strings of characters, numbers, and filenames. 
You can get a list of C-Kermit’s built-in functions by issuing the command show 
FUNCTIONS. 

Character String Functions 

The following functions are used for processing character strings: 

\Fliteral(arg) 

Copies its argument literally, preventing any evaluation of variables (or other func¬ 
tions) from taking place. Example: 

C-Kermit> def \%a foo 
C-Kermit> echo \flit(\%a) = \%a 
\%a = foo 
C-Kermit> 

\Fcharacter (number) 

Returns the single character corresponding to its argument, which must be numeric. 

For example, \fchar (65) is the ASCII letter A, \fchar (193) is Latin-1 A-acute. 
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If you give a negative number or a number larger than 255, only the low-order 8 bits 
are used. Example: 

C-Kermit> echo \fchar(79)\fchar(79)\fchar(70)\fchar(65)1 

OOFAJ 

C-Kermit> 

Characters in the range 128-255 depend on the character set. Here is a way to display 
your terminal’s 8-bit character set (if you have an 8-bit connection to C-Kermit): 

set command bytesize 8 

for \%i 0 255 1 { echo \%i: [\fchar(\%i)] > 

\Fcode( character) 

Returns the numeric code of the given character, for example \f code ( A) is 65, the 
ASCII value of uppercase letter A. If the argument is longer than one character, the 
numeric value of the first character is returned. If there is no argument, the null value 
is returned. 

\Fsubstring( text,start,1ength) 

The result of this function is the portion of the text argument that starts at position 
start and is length characters long, text can be any text and can also be, or include, 
variable names, other functions, etc.; start and length must be numbers or variables 
that have numeric values. The start position is 1 for the first character, 2 for the 
second, and so on. Example: 

C-Kermit> echo \fsubst(hello there,7,3) 
the 

C-Kermit> 

If the length argument is omitted, all of the characters from the starting position to the 
end are returned: 

C-Kermit >def \%a 123456789 
C-Kermit >ech \fsub(\%a,4) 

456789 

C-Kermit> 

\Fright( text,length ) 

Is replaced by the rightmost length characters of the text, or the entire text, whichever 
is shorter. Example: 

C-Kermit> echo "\Friqht(kermit.exe,4)" 

" .exe" 

C-Kermit> 

\Flower(text) 

Converts all uppercase letters in its argument text to lowercase, for example: 
C-Kermit> define \%a FINE 

C-Kermit> echo This is a \Flower(\%a Mess). 

This is a fine mess. 
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\Fupper(text) 

Converts all lowercase letters in its text argument to uppercase. 

\Freverse( text) 

Reverses the order of the characters in its text argument, for example: 
\frev(mupeen)is neepum. 

\Frepeat( text,number) 

Repeats the first argument the number of times given by the second argument. 
Examples: 

C-Kermit> echo \frepeat(=,10) 

C-Kermit> echo +\frep(-+,10) 

\Flpad( text,number,character) 

Left-pads the text to length number with character. If the character is omitted, blank 
(space) is used. Handy for lining things up. Examples: 

C-Kermit >def xx echo \flpad(\%1,10) 

C-Kermit>xx 20 
20 

C-Kermit> xx 1992 
1992 

C-Kermit >echo \flpad($50,10,*) 

***•****$50 

C-Kermit> 

\Frpad( text,number,character ) 

Right-pads the text to length number with character. If character is omitted, blank 
(space) is used. 

\Fexecut e{macroname arguments) 

Executes the named macro with the given arguments (if any) and returns the macro’s 
return value (if any). This function has a single argument, which is the macro name 
followed by its arguments, \fexec () is discussed more fully later in this chapter in 
the section on User-Defined Functions. 

\Fcontents( variable-name ) 

Returns the current definition (contents) of a variable. If the definition includes vari¬ 
able names or function references, these are copied literally, not replaced by their 
values. Example: 

C-Kerxnit> def \%a I like \%b. 

C-Kermit> def \%b pizza 
C-Kermit> echo \%a 
I like pizza. 

C-Kerinit> echo \fcont(\%a) 

I like \%b. 

C-Kermit> 
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\Fdefinition (macro-name) 

Returns the literal definition of the named macro. This is equivalent to the \m() nota¬ 
tion for macro names. Example: 

C-Kermit >define xxx echo \%a 
C-Kermit >echo \fdef(xxx) 
echo \%a 

C-Kermit> echo \m(xxx) 

echo \%a 

C-Kermit> 


Note how different degrees of textual replacement can be achieved by using (or not using) 
the \fliteral() and \fcontents() functions: 


C-Kermit> def \%a foo 
C-Kermit> def \%b I like \%ad. 
C-Kermit> echo \%b 
I like food. 

C-Kermit >echo \fcont(\%b) 

I like \%ad. 

C-Kermit >echo \flit(\%b) 

\%b "" 

C-Kermit> 


(\%a is "foo") 

(\%b includes \%a) 

(Full replacement) 

(Nested variables are handled) 
(Contents of \%b) 

(Nested variables not handled) 
(Take it literally) 

(No replacement at all) 


Each of the following character-string related functions returns a numeric character string 
(a string of digits). Recall that their handling of alphabetic case is governed by the most 
recent SET CASE command. By default, alphabetic case is ignored. 

\Flength( string) 

Returns the length of the argument string, after evaluation of any variables or func¬ 
tions it might contain. Example: 

C-Kermit >def \%a oofal 
C-Kermit >echo \flen(\%a) 

5 

C-Kermit> 

\Findex ( argl ,arg2 [ ,arg3 ] ) 

Looks for a string, argl , in another string, arg2, and tells its starting position: 

C-Kermit >echo \find(ssMississippi) (Find "ss" in Mississippi) 

3 

C-Kermit> 

This means that the first occurrence of the string “ss” starts at position 3 in the string 
“Mississippi”. You can also make this function start looking at a specified position in 
the string instead of starting from the beginning, by including the optional third ar¬ 
gument, arg3, which must be numeric: 

C-Kermit> echo \findex(ss,Mississippi,4) (Find second "ss") 

6 

C-Kermit> 


(Define a variable) 
(Length of its value) 
(The length is 5) 
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Character positions are numbered starting from 1. The first character is at position 1, 
the second character at position 2, and so on. If the string argl is not found in arg2, 
the return value is zero: 

C-Kermit> echo \findex(sss,Mississippi) 

0 

C-Kermit> 

Any of the arguments can be variables of any kind (macro arguments, global variables, 
array elements, or built-in variables), or even functions. In this example we find the 
position of the first “i” in “Mississippi” that comes after the first “s”: 

C-Kermit> def \%a Mississippi 
C-Kermit> echo \findex(i,\%a,\findex(s,\%a)) 

5 

C-Kermit> 

The last example shows the \Findex function calling itself, which is permissible. 

Integer Arithmetic Functions and Commands 

These functions require numeric arguments (numeric strings or variables whose values are 
numeric strings), representing integer (whole) numbers, which can be positive or negative. 
If the arguments are illegal in any way, these functions return the null (empty) string. 

\Fmax( argl,arg2) 

Returns the maximum of its two numeric arguments. Examples: 

C-Kermit> define \%x 9 
C-Kermit> echo \fmax(12,\%x) 

12 

\Fmin ( argl,arg2) 

Returns the minimum of its two numeric arguments. 

\Feval( expression) 

Evaluates the given arithmetic expression. The precedence is the normal, intuitive al¬ 
gebraic (or programming) precedence, and can be altered by the use of parentheses, 
which have higher precedence than any other operator. Spaces may be used to 
separate operators from operands, but they are not required. Examples: 

C-Kermit> def \%x 6 
C-Kermit> def \%y 10 

C-Kermit> echo \feval(\%x) 

6 

C-Kermit> echo \feval(\%x + 2) 

8 

C-Kermit> echo \feval((\%x+2) * \%y) 

80 

C-Kermit> echo \feval(\%x + (2*\%y)) 

26 
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Table 12-2 \Feval() Operators 


Operator 

Fix 

Precedence 

Operation 

Example 

Result 

\%a = 2, 

\%£> = 

-3, \%c = 7, 

\%d = 27 



( ) 

circum 

1 

Group 

(\%a + 3) * (\%b-5) 

-40 

! 

post 

2 

Factorial 

\%cl 

5040 

- 

pre 

3 

Logical NOT 

-1 

-2 

- 

pre 

3 

Negate 

-\%a 

-2 

A 

in 

4 

Raise to power 

2 A \%c 

128 

* 

in 

5 

Multiply 

\%c * 5 

35 

/ 

in 

5 

Divide 

\%d / 5 

5 

% 

in 

5 

Modulus 

\%d % 5 

2 

& 

in 

5 

Logical AND 

\%d & 7 

3 

+ 

in 

6 

Add 

\%a + \%c 

9 

- 

in 

6 

Subtract 

31 - \%c 

24 

1 

in 

6 

Logical OR 

\ %c | 4 

4 

# 

in 

6 

Exclusive OR 

\%d#7 

28 

@ 

in 

6 

Greatest 

Common 

Divisor 

\%d @ 51 

3 


Table 12-2 shows the mathematical operators accepted by \feval(). The heading 
marked Fix tells where the operator goes in relation to its operands. The choices are in 
(the operator goes in between its operands, for example 2 + 2); pre (it goes before its 
operand, for example -1, minus one); post (it goes after its operand, for example 3!, three 
factorial); or circum (it goes around its operands, for example (2 + 2), two plus two in 
parentheses). The “Precedence” column shows the precedence of the operator: the lower 
the number, the higher the precedence. For example, * has higher precedence than + so: 
\feval(2 * 3+4 * 5) 

is 26 because the multiplications are done before the addition (just like you learned in 
school). 

As you can see from the table, parentheses have the highest precedence of all, so you can 
use them to change the order of evaluation: 

\feval(2 * (3 + 4) * 5) 

This makes Kermit evaluate the expression in parentheses, (3+4), first, so the result is 70 
rather than 26. 
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Only integer arithmetic is available: no fractions, no decimals, no scientific notation. The 
remainder of an integer division operation is discarded (except, of course, by the modulus 
operator, which discards the quotient). 

Note that the # Exclusive OR operator is the same as one of Kermit’s comment intro¬ 
ducers, so you can’t use it in an \feval( ) function unless you make sure it is not fol¬ 
lowed by a space: 

C-Kermit >echo \feval(7 # 2) 

?Invalid - echo \feval(7 # 

C-Kermit >echo \feval(7#2) 

5 

See the rules for comments on page 23. 

Two Kermit commands are also available to perform simple arithmetic on variables: 
INCREMENT name [ value ] 

Adds the value to the named variable. If the value is omitted, adds 1. If the variable 
does not have a numeric value, prints an error message and fails. Examples: 
C-Kermit>def \%a 9 


C-Kermit>increment \%a 

C-Kermit>echo 

\%a 

10 


C-Kermit>incr 

\%a 5 

C-Kermit>echo 

\%a 

15 


C-Kermit>incr 

\%a -20 

C-Kermit>echo 

\%a 


-5 

C-Kermit> 

DECREMENT name [ value ] 

Subtracts the value from the named variable. If the value is omitted, subtracts 1. If 
the variable does not have a numeric value, prints an error message and fails. This ex¬ 
ample is a loop that counts down from 10 to 0: 

def \%i 10 

while not < \%i 0 { echo \%i, deer \%i > 

The value given in the INCREMENT and DECREMENT commands need not be a constant. 
You can include variables: 

C-Kermit> define \%n 1 

C-Kermit> while < \%n 5000 { echo \%n, increment \%n \%n > 

1 2 4 8 16 32 64 128 256 512 1024 2048 4096 
C-Kermit> 

And you can use any other item that C-Kermit can evaluate into a number: backslash 
character-codes, array references, function invocations, environment variables, or built-in 
variables. 
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File Functions 

C-Kermit offers two functions for dealing with files. The first, \Ffiles( ), returns the 
number of files that match a given file specification, possibly containing wildcard charac¬ 
ters. The second, \Fnextfile( ), returns the names, one by one, of each file that 
matched the file specification given to \Ff iles (). 

\Ffiles( filespec) 

Returns the number of files that match the given file specification, for example: 

C-Kermit> echo \ffiles(ck*.c) 

37 

C-Kermit> 

If no files match, the result is 0. If too many files match, the result is -1. 


\Fnextfile() 

Returns the next filename that matches the \Ff iles () file specification, until there 
are none left, or until you use \Ff iles () again, or until you execute any command 
(such as SEND, TYPE, or OPEN) that parses a filename. \Ff iles () and \Fnextf ile 
let you write loops that process a selected group of files. 


Here is an example that defines a macro called autosend that you can use to send a 
wildcard group of files to a Kermit server, switching between text and binary mode 
automatically for each file. In this case, binary mode is used if the last four characters 
of the file’s name are .exe. 


define autosend - 
assign \%n \ffiles(\%1),- 
echo files = \%n,- 
declare \&f[\%n],- 
for \%i 1 \%n 1 { - 

asg \&f[\%i] \fnextfile() 


; How many files match 
; Print a message 
; Make an array for names 
; Copy names into array 


for 


\%i 1 \%n 1 { - 

xif eq ".exe" "\fright(\&f[\%i],4)" 
set file type binary,- 
echo Sending \&f[\%i] (binary),- 
send \&f[\%i] - 

} else {- ; 

set file type text,- ; 

echo Sending \&f[\%i] (text),- ; 
send \&f[\%i] - ; 


; Loop for each file 
{- ; If suffix is ".exe" 
; use binary mode, 

; print a message, 

; and send the file 
Otherwise, 
use text mode, 
print a message 
and send the file 




> 


Invoke this macro with a command like: 


C-Kermit> autosend oofa.* 

Replace oof a. * with the file specification of your choice. Of course, this example 
depends on the receiving Kermit’s ability to switch automatically between text and bi¬ 
nary mode based on the Attribute packet sent by C-Kermit (see Table 1-1). 
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Can We Talk? 


You can already carry on a dialog with C-Kermit. It prompts you for a command, you 
type a command, it prompts you for another one, and so on. You can do this because 
you’re a Kermit expert. But suppose you want to set up a procedure for someone who is 
not a Kermit expert. Here are the commands you can use to issue prompts on the screen 
and read responses from the keyboard: 

ASK variable text 

Prints the text on the screen and reads what the user types in response, up to a carriage 
return. Stores what the user types in the named variable, without the terminator. The 
variable can be a global variable (\%a-z), a macro argument (\%l-9), or an array ele¬ 
ment (\&a-z [ ]). The user’s characters echo on the screen as they are typed. 

ASKQ variable text 

“Ask Quietly.” Just like ASK, but does not echo what the user types. Use ASKQ to 
read passwords or other sensitive information. 

Example: 

C-Kermit> ask \%n what is your name\? 

What is your name? 01af 

C-Kermit> askq \%p Hello, \%n, what's your password\? 

Hello Olaf, what's your password?_ 

C-Kermit> 

As you can see, Kermit strips leading and trailing blanks from the ASK and ASKQ prompts, 
and it requires you to quote any question marks with backslash (an unquoted question 
mark gives a help message). If you want to have leading or trailing spaces in the prompt, 
enclose it in curly braces: 

C-Kermit >ask \%n { What is your name\? > 

What is your name? Olga 
C-Kermit> 

When the user responds to the prompt, all of Kermit’s special command editing keys are 
active: Delete, Backspace, Ctrl-W, Ctrl-U, Ctrl-R, etc., so the user doesn’t have to worry 
about typing a perfect response. As always, the question mark key is used to request a 
help message. If the user types a question mark with the intention of including it in the 
response, a helpful message is printed that says to type \? to include a question mark 
literally: 

C-Kermit> ask \%f { What files do you want to send\? > 

What files do you want to send? oofa.? Please respond. 

Type \? to include a question mark in your response. 

What files do you want to send? oofa.\? 

C-Kermit> echo OK, I will send \%f 
OK, X will send oofa.? 

C-Kermit> 
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In an interactive dialog with a user, it is common to ask a question that requires a Yes or 
No answer, A friendly program does not care if the user spells these words out in full or 
abbreviates them, nor about their alphabetic case. And neither does C-Kermit’s getok 
command: 

GETOK [ text ] 

Asks the user a yes-or-no question. The text is the question. If you omit the text, Ker- 
mit supplies the question “Yes or no?”. The user can answer by typing Yes, No, or 
OK in upper- or lowercase, abbreviated or in full. Any other answer results in an error 
message and a repetition of the question. The getok command succeeds if the user 
gives an affirmative answer and fails if the answer is negative. Here is an example in 
which the user is asked whether temporary files should be deleted, and then the files 
are deleted or not according to the answer: 

getok Should I delete your temporary files\? 
xif success { - 

echo Deleting temporary files *.tmp...,- 
delete *.tmp - 
> else {- 

echo OK, I won't.- 

} 

To include leading or trailing blanks, enclose the question text in curly braces: 

C-Kermit> qetok \%a { OK to proceed? > 

OK to proceed? ok 
C-Kermit >sho status 
SUCCESS 
C-Kermit> 


Calculators and Adding Machines 

Here is a macro you can use to have Kermit evaluate arithmetic expressions for you inter¬ 
actively. Kermit’s answer to the pocket calculator: 


define CALC - 

echo Press Return to exit,- 

def \%1 1,- 

while defined \%1 { - 

ask \%1 { expression: >,- 
echo \flpad(\feval(\%1),10)- 

},- 

echo Back to... 


; Say how to exit 
; Initial condition for loop 
; Loop until they want to exit 
; Ask for an expression 
; Evaluate and print answer 

; All done 


To use the calculator, first execute this macro definition. 36 Then just type CALC at any 
time to the C-Kermit prompt. You can type any kind of arithmetic expression listed in 
Table 12-2, and the operands can be either integer constants or variables with integer 
values. 


36 You’U find a copy in the command demonstration file, ckedemo.ini, that is distributed with C-Kermit. 
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(Start Kermit) 


$ kermit 

C-Kermit 5A(188), 23 Nov 92 
Type ? or HELP for help 
C-Kermit> def \%a 7 
C-Kermit> def \%b 9 
C-Kermit> calc 
Press Return to exit 

expression: 1+1 
2 

expression: (D 
720 

expression: 2 A 16 
65536 

expression: (\%a + 3) * (\%b - 
40 

expression: 

Back to... 

C-Kermit> 


(Define some variables) 
(Start the calculator) 

(Add 1 and 1) 

(6 factorial) 

(2 to the 16th power) 

5) (Expression with variables) 
(Press Return to exit) 


Here is a small interactive program that imitates an adding machine, illustrating the use of 
ASKQ along with functions that line things up, WHILE loops, and other items you learned in 
this chapter: 

define ADDINGMACHINE - 
echo Adding machine.,- 

echo Type numbers or press Return to quit...,- 

assign \%3 0,- ; Initialize the sum 

while = 1 1 {- ; Loop till done 

askq \%1,- ; Wait for a number 

if not def \%1 break,- ; Return quits loop 

increment \%3 \%1,- ; Add it to the sum 

write screen \flpad(\%1,10)\flpad(\%3,10),- j Print results 

echo TotalXflpad(\%3,15,.) 

Once this macro is defined (for example, by TAKEing the C-Kermit demo file) you can add 
up a column of numbers any time you want (integers only, positive or negative): just type 
ADDINGMACHINE at the C-Kermit prompt. 


Special Effects 

When commands like ECHO and ASK print your text on the screen, they evaluate all vari¬ 
ables and other backslash codes first. This lets you achieve special effects on the screen. 
For example, you can send escape sequences for clearing the screen, positioning the cur¬ 
sor, highlighting text, changing colors, and so on. Kermit itself has no built-in knowledge 
of terminal control sequences, so you’re on your own for this. A common terminal type is 
the DEC VT100 series [25], and some useful escape sequences (which also apply to the 
VT200, 300, and 400 series) are listed in Table 12-3. For other types of terminals, see 
your terminal manual. 
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Table 12-3 Selected VT100 Escape Sequences 


Escape Sequence 

Kermit Notation 

Description 

Ctrl-H 

\8 

Backspace cursor 

Ctrl-I 

\9 

Horizontal tab 

ESC #3 

\27#3 

Double height/width line, top half 

ESC #4 

\27#4 

Double height/width line, bottom half 

ESC #6 

\27#4 

Double width line 

ESC D 

\27D 

Moves cursor down one line 

ESC M 

\27M 

Moves cursor up one line 

ESC [r;cH 

\27[r;c H 

Moves cursor to row r, column c 

ESC[r; c r 

\27[r;c r 

Sets scrolling region to row r, column c 

ESC [ 0 J 

\27 [ OJ 

Erases from cursor to end of screen 

ESC [ 1 J 

\27[1J 

Erases from start of screen to cursor 

ESC [ 2 J 

\27[2J 

Erases entire screen 

ESC [ 0 K 

\27 [ OK 

Erases from cursor to end of line 

ESC [ 1 K 

\27 [ IK 

Erases from start of line to cursor 

ESC [ 2 K 

\27[ IK 

Erases entire line 

ESC [ ? 5 h 

\27[\?5h 

Reverse video, whole screen 

ESC [ ? 5 1 

\27 [ \?51 

Normal video, whole screen 

ESC [ 0 i 

\27 [ Oi 

Prints current screen 

ESC [ 4 i 

\27 [ Oi 

Stops transparent printing 

ESC [ 5 i 

\27 [ Oi 

Starts transparent printing 

ESC [ 0 m 

\27[0m 

Regular characters 

ESC[ 1 m 

\27 [ lm 

Bold characters 

ESC [ 2 m 

\27[2m 

Underscored characters 

ESC [ 5 m 

\27[5m 

Blinking characters 

ESC [ 7 m 

\27[7m 

Reverse-video characters 

ESC [ 3x m 

\27 [ 3xm 

Selects foreground color (see Table V-9) 

ESC [ 4x m 

\27[4xm 

Selects background color (see Table V-9) 

ESC Z 

\27Z 

Terminal type query (host to terminal) 

ESC [ ? 1 c 

\27[\?lc 

VT100 terminal ID (terminal to host) 

ESC [ ? 6 c 

\27[\?6c 

VT102 terminal ID (terminal to host) 

ESC [ ? 6 c 

\27[\?62c 

VT200 terminal ID (terminal to host) 

ESC [ ? 6 c 

\27[\?63c 

VT300 terminal ID (terminal to host) 

ESC [ 3 4 h 

\27[34h 

Executes MS-DOS Kermit terminals macro 

ESC [341 

\27[341 

Executes MS-DOS Kermit TERMINALR macro 
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Several of the entries in the table require you to insert specific values. The escape se¬ 
quence to position the cursor to a specific row and column needs the row and column 
number, separated by a semicolon (;). The rows and columns are numbered from one. 
So to position the cursor in the upper left comer of the screen: 

\27[1;1H 

and to put it in row 17, column 53: 

\2 7[17;53H 

To “home” the cursor and clear the screen: 

\2 7[1;1H\27[2J 

The escape sequence for setting the scrolling region requires the row numbers of the top 
and bottom lines; for example, to use lines 7 through 24: 

\27[7;24r 

To make the whole screen the scrolling region, use: 

\27 [ r 

The escape sequences for setting foreground and background color are specific to the 
MS-DOS Kermit and OS/2 C-Kermit VT terminal emulators mnning on PCs with color 
monitors and adapters. The x in the escape sequence is replaced by a digit between 0 and 
7 to select the color (0 = black, 1 = red, 2 = green, 3 = orange, 4 = blue, 5 = amethyst, 6 = 
turquoise, 7 = white), for example: 

\27[36m\27[45m 

results in turquoise characters on an amethyst background. 

Here is an example for you to try. If you have an IBM PC or compatible with a color 
monitor running MS-DOS Kermit 3.0 or later or OS/2 C-Kermit, the results will be in 
technicolor. Put these commands in a file and take the file from C-Kermit: 37 

define on_exit echo \27[r\27[0m\27[1;1H\27[2JGoodbye! 

define \%g \27[0m\27[32m\27[7m\frepeat(=,80)\27[0m\27[34m 

echo \27[l;lH\27[2J\%g\27[47m 

ask \%n { What is your name\? \27[30m\27[7m> 

echo \%g 

echo \27[35m\27[5m Welcome to Kermit, \27[30m\27[5m\%n\13\10\%g 
echo \13\10\27[0J\27[7;24r\27[22;lH 

set prompt {\%g\13\10 \27[33mWhat is your command\? \27[34m> 

Without giving away any secrets, it can be observed that this program does some unusual 
things to VT-series terminals. Note the use of the ON_EXlT macro to put the terminal back 
to normal when C-Kermit exits. 


37 A copy of this file is distributed with C-Kermit as ckevt.ini. 
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PC Printing 

Here is a simpler but a somewhat more useful example of using escape sequences. It lets 
C-Kermit print a file on your local printer if you have a VTlOO-series terminal (VT102 or 
higher) or compatible, or an IBM PC or compatible with MS-DOS Kermit. It sends the 
escape sequence to turn on transparent printing, then displays the file, which should cause 
your terminal or emulator to send the text to the printer instead of the screen, and then 
sends the escape sequence to turn off transparent printing, 
define vtprint echo \27[5i, type \%1, echo \27[4i 
Execute this macro definition, and then print files on your local printer like this: 
C-Kermit> vtprint oofa.txt 


File Transfer Shortcuts 

Here is a set of easy file-transfer macros you can use between C-Kermit and a PC with 
MS-DOS Kermit. They let you initiate file transfers from C-Kermit while in MS-DOS 
Kermit connect mode, without having to escape back to MS-DOS Kermit. 


MS-DOS Kermit recognizes a special pair of VT terminal escape sequences that it as¬ 
sociates with MS-DOS Kermit macros named TERMINALS and TERMINALR, 38 which you 
can define as follows: 39 

define TERMINALS server, connect ; Respond to PCGET 
define TERMINALR receive, connect ; Respond to PCSEND 

These definitions tell MS-DOS Kermit to enter the appropriate file transfer mode automat¬ 
ically upon receipt of the TERMINALS or TERMINALR escape sequences, and then to 
CONNECT back to the host when the file transfer is complete. 

Also add these lines to your C-Kermit initialization file: 

define PCGET echo \27[\?34h,- ; Send TERMINALS escape sequence 

get \%1,- ; GET the files 

finish ; FINISH MS-DOS Kermit server 

define PCSEND asg \%9 \ffiles(\%l),- ; How many files match? 

if = 0 \%9 end 1 {\?File not found},- ; None, fail 
set delay 1, echo \27[\?341,- ; Send TERMINALR sequence 

if = 1 \%9 send \%1 \%2,- ; Send single file with as-name 

else send \%1 ; or file group with no as-name 


38 See Table 12-3. MS-DOS Kermit must be emulating a VT100 or higher VT-series terminal for these 
sequences to be recognized. 

39 terminalr and terminals are defined this way in the standard initialization for MS-DOS Kermit, 
MSKERMIT.INI. 


266 Programming Commands / Chapter 12 



The PCGET macro sends the TERMINALS sequence to the PC, which activates its TER¬ 
MINALS macro, which in turn puts MS-DOS Kermit in server mode. Then a GET com¬ 
mand is sent to the PC for the desired files, and when the transfer is complete, a FINISH 
command is sent to take MS-DOS Kermit back out of server mode. Then MS-DOS Ker¬ 
mit executes the next command from the TERMINALS definition, which is connect, so 
you are automatically back where you started. 

The pcsend macro works in a similar way, but it also does a bit of extra checking to see 
whether you are sending one file or a group of files, so it can use the appropriate form of 
the send command. 

Now, at the C-Kermit prompt you can use PCSEND to send a file to your PC and PCGET to 
get a file from your PC without ever having to escape back to the MS-DOS Kermit 
prompt. Try it! Remember, if a C-Kermit command needs to include directory fields in a 
PC filename, be sure to double the backslashes. Examples: 

C-Kermit> pcqet mskermit.ini 
C-Kermit> pcqet c:\\dos\\confiq.sys 
C-Kermit> pcsend ckermit.ini 

C-Kermit> pcsend ckermit.ini c:\\ckermit\\ckermit.ini 


User-Defined Functions 


You’ve seen Kermit’s built-in functions. Now you’ll learn to write your own. A 
user-defined function is a macro that returns a value. To return a value, a new command 
is needed: 

RETURN [ value ] 

Terminates the execution of the current macro and makes the value available to the 
caller (that is, the command level from which the macro was invoked). If the return 
command is used in a command file, it can not return a value; only macros may return 
values. The return command can not be used in the command list of a for, while, 
or xif command. Here is a user-defined function that returns the first character of its 
argument: 

define first return \fsubstr(\%1,1,1) 

The return command can also be used without a value, in which case an empty (null) 
value is returned, in which case it is equivalent to the END 0 command. 

But exactly how is the function’s value returned? It is returned in two ways: first, it is 
stored in the built-in variable \v (return): 

C-Kermit> define first return \fsubstr(\%1,1,1) 

C-Kermit> ask \%a { Type something: } 

Type something: oofa 


User-Defined Functions 267 






C-Kermit> first \%a 

C-Kermit> echo The first character of \%a is "\v(return)". 

The first character of oofa is "o". 

C-Kermit> 

Second, if you put the macro invocation (that is, the macro name followed by its ar¬ 
guments) inside the parentheses of the \f execute () function, the macro’s RETURN value 
becomes the result of \ f execute (): 

C-Kermit> echo The first character of \%a is "\fexec(first \%a)". 

The first character of oofa is "o”. 

C-Kermit> 

If a macro does not include a RETURN statement, or it omits the RETURN value, 
\fexecute() and \v(return) return the null (empty) value. 


Functions that Call Themselves 

User-defined functions can refer to macro arguments, global or built-in variables. They 
can call upon built-in functions and other user-defined functions, and they can even call 
upon themselves. Here, for example, is a function that adds all the numbers from 1 up to 
and including its argument: 40 

def sum if not def \%1 return,- ; Make sure there is an argument 

if not numeric \%1 return,- ; Make sure argument is numeric 

if not > \%1 0 return,- ; Make sure argument is positive 

if = \%1 1 return 1,- ; If argument is 1, the sum is 1 

else return \feval(\%l + \fexecute(sum \feval(\%l - 1))) 

Translated into English, it reads something like this: If you ask me to add up all the num¬ 
bers from 1 to 1, I can tell you right away the answer is 1. If the number is larger than 
one, the answer is the number you gave me plus the sum of all the numbers less than that. 
The process repeats to get the sum of “all the numbers less than that,” until we reach 1. 
This process is called recursion. To give yourself a better idea how it works, try working 
through the process for the number 3. 

You can write a simple macro to call the sum function and print its value: 

C-Kermit> def addemup echo sum = \fexec(sum \%1) 

C-Kermit >addemup 6 
sum = 21 

C-Kermit >addem 11 
sum = 66 
C-Kermit> 

The sum function will not work with numbers larger than C-Kermit’s maximum recursion 
depth (which is 20 by default) plus one. 


^Of course, we all know there is a closed solution to this problem: (n x (n + 1)) / 2, compliments of the 
7-year-old Karl Friedrich Gauss (1777-1855). 
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One final note about user-defined functions: any Kermit action commands (like SEND, 
MSEND, RECEIVE, CONNECT, SERVER, GET, REMOTE, FINISH, BYE, or MAIL) that you include 
in a macro to be executed by \ fexecute () will be ignored. This is because the 
\f execute ( ) function is parsed and executed in the middle of another command, and af¬ 
fairs would become quite confused if a file transfer display or terminal emulation screen 
suddenly popped up before the command containing the \f execute () was finished. 

Reading and Writing Files and Commands 

Like any conventional programming language, C-Kermit lets you open, read, write, and 
close files. Computer people call this I/O (Input/Output). The commands, not surpris¬ 
ingly, are OPEN, READ, WRITE, and CLOSE. 

OPEN { READ, WRITE, APPEND } filename 

Opens the given file in READ, WRITE, or APPEND mode. A READ file must already ex¬ 
ist and is opened for reading only. A write file is created as a new file, overwriting 
any existing file of the same name. An APPEND file, if it already exists, will have new 
information added to the end of it. If it does not exist, it is created as a new file. 

open read oofa.txt ; Read from the file oofa.txt 

open write oofa.new ; Create the file oofa.new 

open append oofa.log ; Write to end of oofa.log 

These commands fail if the file can’t be found or can’t be opened in the desired mode, 
for example if a file is protected against you. 

OPEN { JREAD,!WRITE } command 

You also can open files that are not really files at all, but system commands, programs, 
or applications, and then read from their output or write to their input. Examples: 
open Iread dir /except=(*.doc,*.hlp) /after=yesterday ck*.* 

The example causes VMS or Open VMS to produce a list of all the files in the current 
directory whose names start with ck, except the ones with filetypes of , doc or . hlp, 
that were created since yesterday. C-Kermit can read this list and use it, for example, 
to send the selected files. 

The next example shows how Kermit can write lines of text to the UNIX, OS/2, or 
OS-9 SORT utilities directing the sorted output to the file alpha. txt: 
open !write sort > alpha.txt 

Only one READ or 'READ file can be open at once, and only one WRITE, ! WRITE, or 
APPEND file can be open at once. Reading from and writing to subprocesses only 
works under operating systems that support straightforward methods of input and out¬ 
put redirection. 
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Now that we know how to open files and processes for reading and writing, we also need 
to get data in and out of them. For this, we use the read and write commands: 

READ variable-name 

Reads the next line from the current open read or open sread file and makes it the 
value of the named variable, for example: 

read \%a 

If no more lines remain in the file, the command fails and the file is closed automati¬ 
cally. Here is an example that reads and displays an entire file: 

open read oofa.txt 
read \%a 

while success { echo \%a, read \%a > 

WRITE file text 

Writes the given text to the indicated log or file. The text can include backslash codes, 
variables, etc., which are fully evaluated before the text is written. The text is not ter¬ 
minated by a line terminator in the output file unless you include the appropriate back¬ 
slash code(s). Example: 

write debug-log { Here is where the trouble starts...\13\10} 

The file can be any of the following files or logs, which must already be open: 

DEBUG-LOG 

The C-Kermit debugging log (opened with LOG DEBUG). 

FILE 

The currently open WRITE, !WRITE, or APPEND file. 

PACKET-LOG 

C-Kermit’s packet log (opened with LOG PACKETS). 

SCREEN 

Your screen, write SCREEN is just like ECHO except that WRITE does not supply a 
line terminator at the end. The SCREEN “file” is always open, so C-Kermit does 
not give you a command to open or close it. 

ERROR 

Just like WRITE screen, but using standard error rather than standard output. Use¬ 
ful on systems like UNIX that separate the two, especially when output redirection 
has been done on standard output. 

SESSION-LOG 

C-Kermit’s session log (opened with LOG SESSION). 

TRANSACTION-LOG 

C-Kermit’s file transfer transaction log (opened with LOG transactions). 
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When you are finished reading or writing a file (or process), you should close it. The 
command is: 

CLOSE name 

Closes the named file: debug-log, packet-log, session-log, transaction-log, 
read, 1READ, write, ! WRITE, or append. A read or !READ file is closed automatically 
when end-of-file (EOF) is encountered during a read operation, but it does no harm 
to close it again, write, !write, and append files should be closed explicitly. All 
files are closed automatically when you exit or QUIT from C-Kermit. 


Here is a C-Kermit program that reads lines from one file, oofa.txt, and writes them 
into another file, numbered . txt, with line numbers added: 


set take error off 
open read oofa.txt 
open write numbered.txt 
define \%c 0 
: loop 
read \%a 

if fail goto done 
increment \%c 

write file \flpad(\%c,3). \%a\10 

goto loop 

:done 

close write 

echo Lines copied: \%c. 


So EOF can be handled 
Open input file "oofa.txt" 

Open output file "numbered.txt 
Start line counter at zero 
Loop to read all lines 
Read one line into \%a 
Catch EOF this way 
Count the line 
Format and write it 
Go back and get more 

Finished, close the files 
Print a message 


A Mass Mailing 

In this example we use C-Kermit’s file input/output feature on a UNIX computer to send 
annual review letters to our employees via electronic mail—the personal touch! These are 
form letters that look like this: 

Dear \m(name). 

You have done a \m(word) job this year. 

Keep up the \m(word) work. 

This is called a boilerplate , and we have stored it in a file called BOILER. It contains 
C-Kermit variables that will be filled in by our program for each employee, based on 
records in another file called EMPLOYEES that look like this: 

name address comment 

In each record, name is the employee’s name, address is the employee’s electronic mail 
address, and comment is a word characterizing the employee’s performance for the year, 
for example: 

Olga ole great 
Olaf oop swell 
Ivan itt terrible 
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Here is the program that reads and processes the records, sending personalized mail to 
each employee. Store this in a file called reviews and then take reviews. 

define \%d 100 ; Maximum lines in a letter 

declare \&z[\%d] ; Array for lines 

def split asg name \%1,- ; SPLIT macro assigns words in its 

asg user \%2,- ; argument to separate variables 

asg word \%3 

open read boiler ; Open the boilerplate file 

if fail stop 1 Can't open boilerplate file 


; Loop to read each line of boilerplate file. 


for \%n 1 \%d 1 {- 
read \&z[\%n],~ 
if fail break- 


; \%n is the line number 
; Store this line in the array 
; Stop at end of file 


} 

if = \%i \%d - ; If too many lines before end of file, 

end 1 Your letter is too long ; stop here 


; Read employee records 

r 

def \%m 0 ; 

open read employees ; 

if fail - ; 

end 1 Can't open employee file 

:loop ; 

read \%e ; 

if fail goto done ; 

increment \%m ; 

split \%e ; 

; Write boilerplate lines to mail 

f 

open Iwrite mail \m(user) ; 

for \%i 1 \%n 1 {- ; 

write file \&z[\%i]\10- ; 

> 

close write ; 

goto loop ; 

:done ; 

echo Done, letters: \%m ; 


Employee counter 
Open the employee file 
Handle failure 

Loop for each employee 

Read a record 

Failure means we're done 

Got a record, count the employee 

Get name, address, and comment 

program, making substitutions 

Start the mail program 
Write lines 1 through n 
to the mail program "file" 

Close the mail program 
Go back for next employee 
Come here when finished 
Print completion message 


Now you have fulfilled your managerial responsibilities, spending mere seconds on a task 
that normally takes weeks. While your employees are contemplating their review letters, 
you can go back to playing Space Adventure on your computer. 
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Chapter 13 


Script Programming 


You’re probably wondering what Chapters 11 and 12 have to do with data communica¬ 
tions and file transfer. On the surface, not much. But the programming techniques intro¬ 
duced there—repetitive loops, decision making, and so on—resemble the things you do 
yourself when you are interacting with a remote computer. In this chapter, you will use 
these techniques to teach C-Kermit to do automatically exactly what you do when you use 
it by hand to connect to, log in to, and use a remote computer or service. 

Anything you do with Kermit—whether at the command prompt or in CONNECT mode—in 
a routine and repetitive way is a good candidate for automation. A certain sequence of 
commands is always required for dialing out or for making a network connection. A cer¬ 
tain dialog is required for logging in to a particular remote computer or service. Automat¬ 
ing these routine procedures has all sorts of benefits. It makes them easier, it makes them 
easily accessible to the computer-shy, and it lets computers talk to each other even when 
no humans are around: late at night when phone rates are lowest, the computers can call 
each other up and exchange data automatically. 

oooo 

The material in this chapter is primarily for those who use C-Kermit in local 
mode ; that is, for dialing out or making network connections from C-Kermit to 
remote computers or services. If you will be using C-Kermit only in remote 
mode, you might want to skip this chapter. 
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Automated Connection Establishment 


Before you can use a remote computer or service, you must establish a connection to it 
from your local computer. C-Kermit supports three types of connections: direct, network, 
and dialed. These methods are described in Chapter 3. 

Let’s write three general-purpose macros to automate the connection task, one for each 
type of connection. First we’ll handle direct serial connections. For this kind of connec¬ 
tion, Kermit only needs to know the device name and the connection speed. Let’s define a 
macro that takes these two items as arguments, issues the appropriate commands, and 
checks to make sure the commands were successful: 

COMMENT - SERIAL macro. Arguments: 

; \%1 = device name 
; \%2 = speed 

define SERIAL - 
if < \v(argc) 3 - 

end 1 Usage: SERIAL device speed,- 
set line \%1,- 
if failure - 

end 1 Can't open device: \%1,- 
set speed \%2,- 

if fail end 1 Unsupported speed: \%2,- 
echo Connection successful. 

The macro parameter \%1 is the device name and \%2 is the connection speed in bits per 
second. Both parameters are required; there is no default device or speed. If you omit any 
arguments, the macro gives a helpful usage message and fails. If you give too many ar¬ 
guments, the extra ones are ignored. Use the SERIAL macro like this: 

C-Kermit> serial /dev/ttyOl 9600 (Direct connection from UNIX) 

C-Kermit> serial txa5 2400 (Direct connection from VMS) 

C-Kermit> serial coml 19200 (Direct connection from OS/2) 

Connection successful. 

C-Kermit> 

Now let’s define a net macro for making network connections. The required items are 
the network type (such as TCP/IP or X.25) and the network host name or address: 

COMMENT - NET macro. Arguments: 

; \%1 = network type 
; \%2 = host name or address 

f 

define NET - 

if < \v(argc) 3 - 

end 1 Usage: NET network host,- 
set network \%1,- 
if fail - 

end 1 unsupported network: \%1,- 


onecK arguments 
Something missing 
OK, set network type 
Did it work? 

No, fail 


All arguments given? 
No 

OK, try to SET LINE 
If this failed, 
print message, quit 
Try to set the speed 
Failed 
Succeeded 
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set host \%2,- 
if fail - 

end 1 can't reach host: \%2,- 
echo Connection successful. 

You can use the NET macro like this: 

C-Kermit> net tcp/ip foo.com 
C-Kermit> net x.25 31182120010300 
Connection successful. 

C-Kermit> 


; Make the connection 
; Did it work? 

; No, fail 
; Yes, done 


(Internet) 


For dialed connections, Kermit needs to know the modem type, the name of the device the 
modem is connected to, the speed for dialing, and the phone number. Since the called 
number might be busy, we will have our dialup procedure try dialing up to 10 times, wait¬ 
ing a full minute between each try. 41 If you are running the CALL macro interactively, you 
can press any key during the 60-second wait to wake it up and try again (this is a property 
of the pause command). Here is our CALL macro: 

COMMENT - CALL macro. Arguments: 

; \%1 = modem type 

; \%2 = device name 

; \%3 = speed 

; \%4 = phone number 

7 

define CALL - 

if < \v(argc) 5 - ; All arguments present? 

end 1 Usage: CALL modem device speed number,- 
set modem \%1,~ ; Set modem type 

if fail end 1 unknown modem type: \%1,- 
set line \%2,~ ; Communication device 

if fail end 1 can't open device: \%2,- 
set speed \%3,- ; Communication speed 

if fail end 1 unsupported speed: \%3,- 
for \%i 1 10 1 { - ; Try up to 10 times 

xif > \%i 1 { - ; Not first time, so ... 

echo Will redial in 1 minute: please wait...,- 
pause 60,- ; Give message, wait one minute 

echo Redialing: try number \%i...,- 

>,- 

dial \%4,- ; Dial the number 

if success goto ok,- ; If it answered, we're done 
hangup,- ; Hangup and continue the loop 

> - 

end 1 Can't place call: \%4,- 
:ok, - 
pause 1,- 

echo Connection successful. 


4 'Adapt this to your own needs and local regulations if necessary. Note: the phone number can also be a 
dialing directory entry. 
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Again, all parameters are required: 

C-Kermit> call 

Usages CALL modem device speed number 
C-Kermit> call telebit /dev/acu 19200 555-9876 
Connection successful. 

C-Kermit> 

The macro issues the DlAL-related commands in the proper order, verifies that each com¬ 
mand was executed successfully, and then places the call. If the call completed success¬ 
fully, the macro exits the FOR loop, pauses for one second, and issues the “Connection 
successful” message. Otherwise, the for loop is continued: a message is printed, Kermit 
waits for one minute, and then redials. If the connection is not made within 10 tries, the 
call macro fails. 

When you give a line, net, or call command and receive the “Connection successful” 
message in return, Kermit is ready to communicate with the remote host or service. Now 
you can give a connect command and go through your normal login procedure. 

These three macros, which are included in the standard C-Kermit initialization file, allow 
you to make different kinds of connections quite easily. For example, you don’t have to 
remember the precise order of commands required for dialing out; the CALL macro takes 
care of the details for you. 


Synchronization Commands 


The connection-establishment macros are useful in their own right, but they are only the 
first step in the automation process. Now let’s take the next step and automate the login 
procedure, in which you get the remote computer’s attention and identify yourself to it. 
The method differs for each type of host or service, but each time you connect to a par¬ 
ticular one, you usually perform the same steps. 

How do you know what to put in a login script? The best way to construct a successful 
script is to go through the connection and login procedure once by hand, observing exactly 
which characters are sent and received, in what order, and with what timing. For example, 
let’s use our new call macro to dial a VMS computer, then CONNECT to it and log in: 

C-Kermit> call hayes /dev/cua 2400 7654321 

Connection successful. (Get confirmation message) 

C-Kermit> connect (Connect to the VMS system) 

<CR> (Type a carriage return) 

Welcome to the Complaint Department 

The more you complain, the longer you live. 

Username: olga (See prompt, type username) 

Password: _ (See prompt, type password) 

Welcome to VMS V5.3 
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Last interactive login on Saturday, 14-MAR-1992 11:47 
Last non-interactive login on Friday, 8-FEB-1992 20:02 

$ (See system prompt) 

Observe what you type and what VMS sends back in return. The VMS system sends two 
types of text to your terminal: informational or greeting messages, and prompts that you 
should reply to. In this example, the prompts are: 

Username: 

and: 

Password: 

The login process is complete when you see the system prompt: 

$ 

That’s a dollar sign, followed by a space, on the left margin (\13\10$\32). 

How can we automate this procedure? Let’s clear up one misconception right away. You 
can’t use the connect command to send precomposed text to the remote computer. The 
CONNECT command always reads from the keyboard, never from a file. To illustrate, the 
following command file: 

set line /dev/ttyh8 

set speed 9600 

connect 

olga 

secret 

will NOT log the user Olga in to the remote computer. It will not send the strings “olga” 
and “secret” out the communication device. When you put a CONNECT command in a 
command file or macro, it does exactly what it does when you issue it interactively: it con¬ 
nects your keyboard and screen to the remote computer. The previous example will do 
just that, and then when you escape back from connect mode, Kermit will try to execute 
the commands “olga” and “secret,” which are not C-Kermit commands at all. 

We can’t simply blast text at the remote computer, expecting it to be processed correctly 
and at the right time. We have no guarantee this will happen. Instead, we want Kermit to 
do exactly what we do when we log in to the remote computer: look for a particular 
prompt, send the appropriate text, look for the next prompt, and so on, ignoring (just as we 
do) all the informational and greeting messages. We should synchronize our responses 
with the remote computer’s prompts; we should not send text to the remote computer until 
it has issued a prompt for it. 

Synchronization is important for many reasons. For example, you must not send charac¬ 
ters on a half-duplex connection until the remote system has given you permission by 
sending you its line turnaround character, such as Ctrl-Q (Xon). If you (or Kermit) do not 
wait for the Xon, the characters sent prematurely are lost. 
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Even on full duplex connections there might be times when “typeahead” is not allowed. 
When you log in to UNIX, for example, the login program clears the input buffer of 
typeahead after issuing the “Password:” prompt and before reading your password, as a 
security measure; any part of your password that you send before the prompt appears is 
lost and your login fails. 

So before we can write our login scripts, we must learn how to synchronize Kermit’s 
responses with the prompts and actions of the remote computer. 


The OUTPUT and INPUT Commands 


A script program is a lot like a movie script containing a dialog between two actors. In a 
C-Kermit script, the actors are the two computers, and their lines are spoken and read, 
respectively, by C-Kermit’s output and input commands. These commands do what 
you would do if you were interacting manually with the other computer during a connect 
session: CONNECT requires a person at the controls, whereas INPUT and output work on 
automatic pilot, output “types” what you would type and input reads the computer’s 
response. 


output \13 
input 5 login: 
output olaf\13 
input 5 Password: 


(Send a carriage return) 

(Wait 5 seconds for login prompt) 
(Send my user ID and <CR>) 

(Wait for password prompt) 


OUTPUT text 

Sends the text out the currently selected communication device (serial port or net¬ 
work). Example: 

C-Kermit> output I am not really typing this text. 

The text may contain any of the backslash codes, variables, or functions described in 
Chapters 11-12. 

C-Kerrait >out The local time is \v(time).\13 

It can also include the special code \B, which means to send a BREAK signal (the let¬ 
ter B can be upper- or lowercase), or the code \L (upper- or lowercase) to send a Long 
BREAK signal: 42 

C-Kermit> output \b (Send a BREAK signal) 

If you want to include leading or trailing spaces in the text, enclose it within curly 
braces: 


C-Kermit> output { hello > 


42 On a serial connection, a BREAK is a 0.275-second spacing (0) condition and a Long BREAK is a 
1.5-second spacing condition. On a TCP/IP telnet connection, both \B and \L send the telnet 
BREAK command to the remote telnet server. 
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The enclosing braces are removed by C-Kermit’s command processor, so the com¬ 
mand just shown sends the word hello with a leading blank and a trailing blank. If 
you want to output text that actually begins and ends with curly braces, use two of 
each: 

C-Kermit> output {{ hello >> (sends "{ hello }") 

Kermit does not add a carriage return or linefeed to the end of the output text. You 
must include the appropriate backslash code, for example: 

C-Kermit> output hello\13 (Include a carriage return) 

The output command succeeds unless there is a device output error, for example if 
the connection was broken. 

INPUT number [ text ] 

This command waits up to the given number seconds for the specified text to arrive 
from the communication device. The text may contain backslash codes, variables, or 
functions, which are evaluated before the arriving characters are scanned, but it may 
not include NUL (ASCII 0) characters, which serve only to terminate the text. To in¬ 
clude leading or trailing spaces in the text, enclose it in curly braces. Alphabetic case 
in the text is ignored unless you have set case on. The 8th bit of each character is ig¬ 
nored if your current parity setting is anything but none (none is the default) or if 
your terminal bytesize is set to 7 (which is the default). If the text arrives within 
the specified interval, the command succeeds. If the specified number of seconds 
passes without the text arriving, the command terminates automatically and fails. 

Here is an example of how to test whether INPUT succeeds or fails: 

input 10 login: ; Wait for login prompt 

if failure end 1 No login prompt 

If you omit the text from the INPUT command, it waits the given interval for any 
character at all, including NUL: 

input 10 ; Wait for any character 

if failure end 1 No input 

The last character that was read by the input command, whether it succeeded or not, 
is available in the \v( inchar) variable. The number of characters read by the most 
recent INPUT command is given by the \v( incount) variable. 

The input and output commands are hooked into the session log. If you have given a 
LOG session command, all characters processed by input and output are recorded in the 
session log, just as if they had been captured during connect mode, except that no con¬ 
versions take place (character-set translation, removal of linefeeds, and so on). 

When you combine the input and output commands with the decision-making powers of 
the IF command, you can make Kermit imitate your own behavior: it “types” what you 
would have typed, it reads the responses, and makes the same decisions you would make. 
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Using the INPUT Buffer 

Characters that are read by the input command are copied into a special place called the 
INPUT buffer. You can refer to the contents of the input buffer at any time using the 
built-in variable \v(input), and you can also look at the results of previous input com¬ 
mands with the reinput command: 

REINPUT number text 

This command works like input except that it scans the input buffer for the text 
rather than reading new characters from the communication device. In other words, it 
reexamines the characters read by recent input commands. If the requested text is 
present, REINPUT succeeds immediately, otherwise it fails immediately. Thus the 
timeout interval is ignored. 


Here’s a small script program in which Kermit dials a Hayes modem, reads the modem’s 
response, and takes various actions depending on the response. The modem’s response is 
a string of characters surrounded by linefeed characters (\ 10). 


set speed 2400 
output atdt7654321\13 
input 40 \10 
if failure - 

end 1 No response 
input 20 \10 
if failure - 

end 1 Incomplete response 
reinput 0 BUSY 
if success - 

end 1 Line is busy 
reinput 0 CONNECT 
if failure - 

end 1 No CONNECT 
reinput 0 CONNECT 1200 
if success set speed 1200 


Use 2400 bps 
Dial the number 

Wait 40 sec for first linefeed 
Did it come? 

Timed out, quit 

Wait 20 sec for next linefeed 

Did it come? 

No 

Got response, was it "BUSY”? 
Yes 

Quit with message 
Was it "CONNECT"? 

No 

Give up 

Yes, did modem speed change? 
Yes, change Kermit's too 


A script program can contain any Kermit commands at all, not just INPUT, REINPUT, IF, 
output, and echo; for example, the SET SPEED command used in the example. 


The input buffer has a fixed size of 256 characters. Each input command adds new 
material where the last input command left off. When the end of the buffer is reached, 
new material wraps around to the beginning, overwriting what was there before (computer 
folks call this a circular buffer). Thus, the words or phrases you are looking for might 
have wrapped around too. The input and reinput commands know how to cope with 
this situation, but if you are searching the \v(input) variable yourself with \findex(), 
you can use a trick like this: 

assign \%i \findex(Enter Username: ,\v( input) \v( input)) 
if = \%i 0 echo Not found 
else echo Found at \%i 
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To handle the possibility that the phrase we are searching for, “Enter Username:”, 
wrapped around, we concatenate the input buffer to itself. This pastes the beginning of 
the phrase at the end of the buffer to the end of the phrase at the beginning of the buffer, in 
case the phrase you are looking for is split in half (clear?). Speaking of clear, you can 
erase the entire input buffer with the CLEAR command: 

CLEAR [ { INPUT-BUFFER, DEVICE-BUFFER, BOTH } ] 

The clear command erases the contents of the INPUT command buffer, the com¬ 
munications device input buffer, or both (the default is both). 

In the following example, the clear command ensures that each line that is input from 
the communication device starts at the beginning of the input buffer, so it can be pro¬ 
cessed as a line of text (in this case, simply displayed) without any extraneous characters 
before or after it. 

set input echo off 
: loop 

clear input-buffer 
input 5 \10 

if eq \fsubstr(\v(input),1,1) 
stop 

write screen \v(input) 
goto loop 

Controlling the INPUT Command 

You can use the SET input command to control how the INPUT and reinput commands 
match character sequences, display their progress, and so forth: 

SET INPUT CASE { IGNORE, OBSERVE } 

Tells whether the input command should pay attention to alphabetic case when com¬ 
paring its text to the characters that arrive from the communication device. The 
default is IGNORE. Caseless comparison is possible only for unaccented Roman letters 
(A-Z = a-z). Synonym: SET CASE { OFF, ON }. 

SET INPUT ECHO { OFF, ON } 

Tells whether the INPUT command should display the characters from the communica¬ 
tion device on your screen as it receives them. The default is ON, meaning that arriv¬ 
ing characters are displayed. 

SET INPUT SILENCE number 

This command tells C-Kermit the longest interval of silence, in seconds, that will be 
tolerated by the input command. If number is less than the timeout interval given in 
the INPUT command, and if number seconds pass without any characters arriving at all 
during the INPUT timeout interval, the INPUT command fails. If number is zero (0), 
which is the default, there is no silence constraint and only the INPUT timeout interval 
applies. Silence is broken by the arrival of any character at all, including NUL. 


; Echo lines ourselves 
; Loop for each line 
; Clear INPUT buffer 
; Read a line 
$ - 

; Stop if line starts with "$" 
; Display the line 
; Go back for more 


Synchronization Commands 281 



SET INPUT TIMEOUT-ACTION { PROCEED, QUIT } 

Tells whether a failure of the input command to match its text within the specified 
timeout interval should cause the current macro or command file to be terminated 
automatically. SET INPUT TIMEOUT QUIT is equivalent to following every INPUT com¬ 
mand with if failure end l. The default is PROCEED, so you can use IF SUCCESS or IF 
failure to decide what to do after each input command. 

If a command file or macro is terminated automatically because of an input failure, the 
take or (implied) DO command also fails. 

International Character Sets 

Character set translation is not done by input, reinput, and OUTPUT commands. If you 
want to OUTPUT a non-ASCII character, include a backslash code for its numeric value in 
the output command, for example: 

output Gr\252\233e\13 

to send Griifie and a carriage return to a host that uses the Latin-1 alphabet. Similarly, if 
you need to match international characters from the remote host in an input command, 
you should also use backslash codes to express their values in the character set used on the 
remote host. See Tables VIII-4-VIII-6. 

Translation is avoided in script commands because it would introduce more problems than 
it could solve: unwanted mistranslations, character-set dependent case conversion, scram¬ 
bling of host-generated escape sequences, plus the possibility that the remote host is using 
a character set that Kermit doesn’t know about. It’s better for you to have total control in 
this critical area. 

The PAUSE and WAIT Commands 

Kermit scripts are often used to navigate through a series of devices until the final destina¬ 
tion is reached. For example, suppose Kermit tells the local modem to dial a number; the 
call is answered by a port selection unit which, after a dialog, connects Kermit to a ter¬ 
minal server for another dialog, and from there to a front end, more dialog, and finally the 
remote host. Switching from device to device can take time, and if Kermit sends charac¬ 
ters before the switching is finished, they might be lost. You can use the pause and wait 
commands to allow for these periods of transition: 

PAUSE [ number ] 

This command does absolutely nothing for the specified number of seconds. It pauses 
for 1 second if the number is omitted. Synonym: SLEEP. Examples: 

C-Kermit> pause 10 (Pause 10 seconds) 

C-Kermit> paus \%s (Use value of variable) 

C-Kermit> pau (Pause 1 second) 
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The PAUSE command can be interrupted by typing any character on your keyboard. 
Interruptions can be detected by an IF FAILURE command: 

echo Please wait for 20 seconds... 
pause 20 

if failure end 1 Please don't touch the keyboard! 
else echo Thank you for your patience. 

The PAUSE command turns out to be surprisingly useful. Many a nonfunctioning 
script can be made to work by inserting pauses at strategic locations. 

MSLEEP [ number ] 

This command sleeps (pauses) for the given number of milliseconds (thousandths of 
seconds). It is not interruptible from the keyboard except by Ctrl-C. Synonym: 
MPAUSE. 

WAIT [ number=1 [ { CD, CTS, DSR j ... 7 7 

This command waits up to the specified number of seconds for all of the given modem 
signals to appear on the currently selected (SET line) serial communication device. If 
no modem signals are included, wait is equivalent to pause. If all the specified 
modem signals don’t appear within the prescribed interval, or if there is an interrup¬ 
tion from the keyboard, the WAIT command fails. Examples: 

wait 10 dsr 

if fail end 1 Please turn on your modem 
wait 45 cd 

if fail end 1 No carrier 
wait 5 dsr cts 

if fail end 1 Modem not ready 

The WAIT command fails immediately if the communication device is not a serial device, 
if the underlying operating system is not capable of reporting modem signal status, or if a 
system error occurs while trying to obtain the modem signals. 


Constructing a Login Script for VMS 


Let’s look again at the procedure for logging in to a VMS computer: 

C-Kermit> call hayes /dev/cua 2400 7654321 

Connection successful. (Get confirmation message) 

C-Kermit> connect (Connect to VMS) 

<CR> (Type a carriage return) 

Welcome to the Complaint Department 

The more you complain, the longer you live. 

Username: olga (See prompt, type username) 

Password: _ (See prompt, type password) 

Welcome to VMS V5.3 
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Last interactive login on Saturday, 14-MAR-1992 11:47 
Last non-interactive login on Friday, 8-FEB-1992 20:02 

$ (See system prompt) 


Now let’s see if we can use the input and output commands to automate the process. 
We’ll begin by writing a C-Kermit command file called VMS.SCR: 


set input timeout quit 
set input echo off 
output \13 
input 10 Username: 
output olga\13 
input 5 Password: 
output secret\13 
input 100 (\13\10$ > 


INPUT failures are fatal 

Work quietly 

Send a carriage return 

Wait 10 sec for username prompt 

Send username and carriage return 

Wait 5 sec for password prompt 

Send password and carriage return 

Wait 100 sec for system prompt 


This is a straightforward translation of our actions and decisions into a Kermit script 
program. We don’t know yet whether it actually works, but even on the surface it has one 
extremely serious flaw: the user’s password is stored in the command file. 


Never store a password in a file! 

This is easy to fix. Just have the script program prompt for the password: 

askq \%p Password: ; Make the user type the password 

and then use this variable when it is needed: 

input 5 Password: ; Wait 5 sec for password prompt 

output \%p\13 ; Send password and carriage return 


Now let’s run our script and see what happens: 

C-Kermit >call hayes /dev/cua 2400 T987-6543 
Connection successful. 

C-Kermit> take vms.scr 

Password:_ 

?Input timed out 
C-Kermit> 

It didn’t work, but we don’t know why. 

The first step in debugging a script program is to SET INPUT ECHO ON so we can watch it in 
action. Since there was a SET INPUT ECHO OFF command in the VMS. SCR file, we simply 
remove it and take the file again: 

C-Kermit> call hayes /dev/cua 2400 T987-6543 
Connection successful. 

C-Kermit> take vms■scr 
Password:_ 

Welcome to the Complaint Department 

The more you complain, the longer you live. 
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login: olga 
Password: 


Welcome to VMS V5.3 

Last interactive login on Saturday, 14-MAR-1992 11:48 
Last non-interactive login on Friday, 8-FEB-1992 20:02 

?Input timed out 
C-Kermit> 

It looks like the script program logged us in correctly, but we never got the system 
prompt. Don’t panic. Scripts like this usually work. The failure of this one gives us a 
chance to track down and fix a subtle problem. In this case, there was an invisible 
CONVERSATION between VMS and your terminal, using control characters and escape se¬ 
quences that did not appear on your screen when you logged in by hand. 

To view these elusive fragments, use Kermit’s set debug session command to display 
control characters in A x notation rather than passing them along to your terminal emulator. 
In this example, we log in to a VMS computer again: 

C-Kermit> set line /dev/ttyb 
C-Kermit> set debug session 
C-Kermit> connect 

Connecting to /dev/ttyb, speed 9600. 

The escape character is CTRL-\ {ASCII 28). 

Type the escape character followed by C to get back, 
or followed by ? to see other options. 

(Debugging Display...) 

A M A J A G A M A J A M A JWelcome to the Complaint Department A M A JThe mor 
e you complain, the longer you live. A M A J A M A JUsername: OLGA A M 

A J A MPassword:_ A M A JYou again? Welcome to VMS V5.3 

A M A J A M A JLast interactive login on Saturday, 14-MAR-1992 11:5 
2 A M A JLast non-interactive login on Friday, 8-FEB-1992 20:02"' 

M A J A [Z A [[c A [[0c A M A J%SET-W-NOTSET, error modifying TWA26 : a M a J 
-SET-I-UNKTERM, unknown terminal type A M A J$ Ctrl-\C 
(Back at Local System) 

C-Kermit> 

A M represents Carriage Return, A j is Linefeed, and A [ is Escape (see Table VIII-1 on page 
461). The user typed in her username and password, and then after the “last login” mes¬ 
sages were printed, the characters A [ z appeared on the screen: Escape followed by the let¬ 
ter Z, which is VMS’s terminal identification query. Normally, you don’t see this; your 
terminal or terminal emulator intercepts it and replies automatically with its ID (see Table 
12-3 on page 264). 


But your terminal did not respond this time because the Escape character was translated 
by Kermit’s debugging display to A [ (Circumflex and Left Bracket), so VMS timed out 
after several seconds and sent additional terminal ID requests in different formats. Finally 
VMS gave up and complained that your terminal type was unknown. Meanwhile, we’ve 
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learned all we need to correct our script program and automate our VMS logins. The new 
vms. scr file handles the terminal ID request and it also includes several other improve¬ 
ments. For example, it tries three times to get the VMS Username: prompt in case there 
was noise on the communication line. 


COMMENT - C-Kermit command file VMS.SCR. 


Log in to a VMS system 

askq \%p Password: 

set count 3 

:getlogin 

output \13 

input 5 Username: 

if success goto dologin 


Make user type in password 
Allow 3 tries to log in 


Send a carriage return 
Wait for login prompt 
Got it 


if not count end 1 No Username prompt 


goto getlogin 

:dologin 

output olga\13 

input 5 Password: 

if fail end 1 No password prompt 

output \%p\13 

input 10 \27Z 

if success output \27[\?lc 
input 200 {\13\10$ } 
echo Login successful. 


Try again 

Send my username 

Wait for password prompt 

Send password, carriage return 
Get terminal ID query 
Send VT102 terminal ID 
Wait for system prompt 


This command file should work. Let’s try it: 

C-Kermit> call hayes /dev/cua 2400 T987-6543 
Connection successful. 

C-Kermit> take vms.scr 

Password:_ 

Login successful. 

C-Kermit> 


It works, but it still has some shortcomings. First, it works only for user Olga. Each user 
would have to edit this file to substitute the appropriate username. And then there is the 
fact that the script is a command file. Suppose you change your default directory and try 
to run it again: 

C-Kermit> cd articles 

C-Kermit >call hayes /dev/cua 2400 T987-6543 
Connection successful. 

C-Kermit> take vms.scr 
?No files match - vms.scr 
C-Kermit> 

Kermit can’t find it. You could solve this problem by giving the full pathname of the 
command file in your take command. Or you could define a macro to do it: 
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define govms take -olga/kermit/vms.scr ; (UNIX) 

define govms take [olga.kermit]svms.scr ; (VMS or OpenVMS) 

define govms take c:\\kermit\\vms.scr ; (OS/2) 

define govms take :udd:olga:kermitsvms.scr ; (AOS/VS) 

etc... 

But now you need different definitions of the VMS macro depending on the operating sys¬ 
tem. If you keep the file in your home (login) directory, you can use C-Kermit’s portable 
notation: 

define govms take \v(home)vms.scr ; (All systems) 

This statement should work on any computer that C-Kermit runs on. 


But you can fix the problems with this command file even more simply by rewriting it as a 
macro and putting its definition in your C-Kermit initialization file. That way, it is always 
ready for use, and the username and password can be passed to it as macro parameters. 

COMMENT - VMSLOGIN macro. Arguments: 

; \%1 = VMS user ID 

; \%2 = Password. If password not supplied, it is prompted for. 


define VMSLOGIN - 

if < \v(argc) 2 end 1 Usage: \%0 userid password,- 
while equal "\%2" "" { - 

askq \%2 { \%l's password: > - 

set parity none,- ; Set communication parameters 

set duplex full,- 

set handshake none,- 

set flow xon/xoff,- 

set term byte 8,- 

set comm byte 8,- 

set input timeout quit, 

for \%il31{- ; Try 3 times to get prompt 

out \13,- ; Send carriage return 

in 5 Username:,- ; Look for prompt 

if success goto dologin - ; Success, go log in 

end 1 No Username prompt, 

:dologin,- ; Come here to log in 

out \%1\13,- ; Send username, carriage return 

inp 5 Password:,- ; Wait 5 sec for this prompt 

if fail end 1 No password prompt,- 

out \%2\13,- ; Send password 

def \%2, ; Quickly erase it from memory 

set input echo off,- ; Protect terminal from this 

inp 10 \27Z,- ; Look for terminal ID query 

if success output \27[\?lc,- ; Send response 

set input echo on,- ; Echo input again 

inp 200 {\13\10$ },- ; Wait for system prompt 

echo Login successful. 
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Shall we dissect this macro definition? The first command in the definition: 


if < \v(argc) 2 end 1 Usage: \%0 userid password,- 

checks to make sure you specified a user ID. If not, it gives you a usage message and 
fails. The next command is a while loop: 

while not defined \%2 { - 

askq \%2 { \%l's password: } - 

>,- 

If the \%2 password variable is not already defined, C-Kermit prompts for a password and 
reads it from the keyboard into the \%2 variable without echoing it. A while loop is used 
here rather than a simple IF command to make sure the user actually types in a password. 
If the user just hits the Return (Enter) key, the password prompt comes back, and the 
process repeats until some nonblank characters have been entered. The next section: 

set parity none,- 
set duplex full,- 
set handshake none,- 
set flow xon/xoff,- 
set term byte 8,- 
set comm byte 8,- 

establishes the appropriate communication parameters. Some of them happen to be iden¬ 
tical to C-Kermit’s defaults, but we set them here deliberately to ensure the right settings 
in case they have been changed. Now we can start to send and read characters. The fol¬ 
lowing section: 

for \%i 1 3 1 { - ; Try 3 times to get prompt 

out \13,- ; Send carriage return 

in 5 Username:,- ; Look for prompt 

if success goto dologin - ; Success, go log in 

},- 

end 1 No Username prompt,- 

sends a carriage return and waits 5 seconds for the Username: prompt. If the prompt does 
not appear within the 5-second interval, the process is repeated up to 3 times. If the 
prompt does not appear after 3 tries, the VMSLOGIN macro fails. If it does appear, we go 
to the final section: 


:dologin,- 

out \%1\13,- 
inp 5 Password:,- 


Come here to log in 

Send username, carriage return 

Wait 5 sec for this prompt 


if fail end 1 No password prompt,- 


out \%2\13,- 
def \%2, 

set input echo off,- 
inp 10 \27Z,- 

if success output \27[\?lc,- 
set input echo on,- 
inp 200 {\13\10$ },- 
echo Login successful. 


Send password 

Quickly erase it from memory 

Protect terminal from this 

Look for terminal ID query 

Send response 

Echo input again 

Wait for system prompt 
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which sends the user ID and a carriage return (\%1 is the user ID and \ 13 is the carriage 
return), waits five seconds for the Password: prompt, sends the password that you had 
typed in previously, waits 10 seconds for the terminal type query (\27Z), responds with 
the VT-100 terminal ID (\27[\?lc, that is, escape-left-bracket-question-mark-one-c). 
input echo is turned off during this period to prevent your terminal from seeing the ter¬ 
minal type query. The macro then waits up to a minute for the system prompt, dollar sign 
on the left margin followed by space ({\13\10$ >), to appear. If it does, the VMSLOGIN 
macro completes successfully. 

The 200-second wait should allow ample time for system messages to be displayed and 
your login command procedure to be executed. Of course, the script continues as soon as 
the prompt appears; it doesn’t always wait 200 seconds (and if it did, it would fail). If 
your system’s prompt is anything other than dollar sign on the left margin followed by 
space, you’ll have to change the input command accordingly. 

And so we have constructed our first login script. Before writing more of them, let’s 
reflect on how it fits in to the big picture. The only prerequisite for VMSLOGIN is that the 
connection is already established. VMSLOGIN doesn’t care what kind of connection it is. 
If you have defined this macro (for example, in your C-Kermit initialization file), you can 
use it after any of the connection-establishment macros, serial, net, or call: 

C-Kermit> serial /dev/ttyh8 19200 
Connection successful. 

C-Kermit >vmslogin ivan 

ivan's password: _ 

Login successful. 

C-Kermit> 

In the next few sections, we will write login scripts for several other kinds of computers 
and services. When we are done, we will have quite a versatile set of building blocks, al¬ 
lowing us to make many kinds of connections to many kinds of computers and services, 
and they will be completely portable among all implementations of C-Kermit. And then 
we will see what we can build with these blocks. But first let’s look at how to log in to a 
few more common computers and services. 

A UNIX Login Script 

The normal procedure for logging in to a UNIX computer is to type a carriage return 
(press the Enter key), type a username in response to the login: prompt, and then type a 
password in response to the Password: prompt. But unlike VMS, most UNIX systems do 
not use your initial carriage return for speed recognition. Therefore, it is possible that the 
speeds on the two ends don’t agree: the login prompt appears to you as garbage, and 
whatever you type looks like garbage to UNIX. 
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You can’t be expected to change your connection speed to match that of the remote UNIX 
system because your communication device might not support the UNIX speed. For ex¬ 
ample, you might have dialed from a 2400 bps modem, but the UNIX system answers at 
9600 bps. Therefore you have to get the UNIX system to change its communication speed 
to match yours. There is a time-honored ritual to accomplish this: when you send a 
BREAK signal, which comes through as a BREAK at any speed, UNIX changes its speed 
and reprints its login prompt. If you can’t read it, send another BREAK, and so on until 
the login prompt appears legibly. 


Here is our UNIXLOGIN macro. It is similar to the vmslogin macro, except it includes the 
BREAK speed-changing trick and it omits the terminal ID inquiry and response, since 
most UNIX systems don’t do this. BREAK is sent up to 15 times, to try each of the com¬ 
munication speeds supported by UNIX: 


COMMENT - UNIXLOGIN macro. Arguments: 
; \%1 = user ID 
; \%2 = password 


define UNIXLOGIN - 


if < \v(argc) 2 end 1 Usage: \%0 userid password,- 
while not defined \%2 { - 

askq \%2 { \%l's password: > - 


set terminal echo remote,- 
set terminal byte 7,- 
set command byte 7,- 
set parity none,- 
set handshake none,- 
set flow xon/xoff,- 
set case on,- 
out \13,- 

for \%i 1 15 1 { - 
in 5 login:, - 
if success goto dologin,- 
output \B - 


Set communication parameters 
Most UNlXes use even parity 

But not for file transfer 


Case is important in UNIX 
Send a carriage return 
Try up to 15 times 
to get login prompt 

Send BREAK to change speed 


end 1 No login prompt,- 

:dologin,- ; Have login prompt 

out \%1\13,- ; Send user ID 

inp 5 Password:,- ; Get Password prompt 

if fail end 1 No password prompt,- 
out \%2\13,- ; Send password 

def \%2,- ; Erase password 

inp 60 {\13\10$ ; Wait for prompt "$ ” 

if fail end 1 No system prompt,- 
echo Login successful. 


Like the vmslogin macro, the UNIXLOGIN macro can be used after any of the connection- 
establishment macros: SERIAL, NET, or CALL. If your UNIX prompt is not a dollar sign on 
the left margin followed by space, change the final INPUT command accordingly. 
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An IBM Mainframe Linemode Login Script 


This example shows an interactive login to an IBM mainframe running the VM/CMS 
operating system over a half-duplex line-at-a-time connection. The login process looks 
like this: 


VIRTUAL MACHINE/SYSTEM PRODUCT—CUVMB —PRESS BREAK KEY 

1 (Press BREAK key here) 

Enter one of the following commands: 

LOGON userid (Example: LOGON VMUSER1) 

DIAL userid (Example: DIAL VMUSER2) 

LOGOFF 

.<Ctrl-Q> logon olaf 
Enter password: 

************************** 

HHHHHHHHHHHHHHHHHHHHHHHHHH 
SSSSSSSSSSSSSSSSSSSSSSSSSS 
.<Ctrl-Q> 


In response to the message press break key, you have to send a break signal. Then at 
the dot prompt (which happens to be followed by a Ctrl-Q line turnaround character, 
which you can verify using set DEBUG session) you enter your user ID. Then you are 
given a password prompt, which includes a lot of overprinted asterisks, H’s, and S’s to 
cover your password (in case you are logging in from a hardcopy terminal), followed by 
the dot prompt and Ctrl-Q. Once you have supplied a correct password, greeting mes¬ 
sages are printed and you must type a carriage return in response to the system prompt two 
times before you can begin to do any work. (At least, that’s how our local VM/CMS sys¬ 
tem operates.) Here is a VMLINELOGIN macro that takes care of all this: 


COMMENT - VMLINELOGIN macro. Arguments: 
; \%1 = User ID 
; \%2 = Password 


define VMLINELOGIN - 

if < \v(argc) 2 end 1 Usage: \%0 userid password,- 
while not defined \%2 { - 

askq \%2 { \%l's password: > - 

set parity mark,- 
set flow none,- 
set handshake xon,- 
set duplex half,- 


Set communication parameters 


set input timeout quit,- 
input 10 BREAK KEY,- 
pause 1,- 
output \B,- 
input 10 .\17, output logon \%1\13,- 
input 10 .\17, output \%2\13,- 
input 10 . \17, output \13,- 
input 10 .\17, output \13,- 
echo Login successful. 


Don't bother with IF FAILURE 
Look for BREAK KEY prompt 
Wait a second 
Send BREAK 

Now log in 
Send password 
Send carriage return 
Send another one 
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Once we have made sure we have the user ID and password, we set the IBM mainframe 
linemode communication parameters, which are very different from Kermit’s defaults. 
Then we send the BREAK signal and the required material in response to each of four 
identical prompts (period followed by Control-Q). For variety as well as compactness, we 
have omitted the if failure commands after each INPUT command. Instead, we have 
simply SET input timeout quit to force the entire macro to fail automatically if any of its 
INPUT commands failed, in which case the FAILURE status is returned. Like the other 
login macros, the vmlinelogin macro can be used in conjunction with any of the 
connection-establishment macros. 

An IBM Mainframe Fullscreen Login Script 

The more popular style of communication with IBM mainframes is called block mode or 
full screen , in which the IBM mainframe believes it is connected to a 3270-style terminal, 
but in reality the connection goes through a protocol converter (such as an IBM 7171 or 
3174 AEA) that converts the 3270 screens to your ASCII terminal type. These devices 
generally use full duplex communication, Xon/Xoff flow control, and even parity. 

For the screen to be painted correctly, the protocol emulator must know your terminal 
type. In general the procedure is to type a carriage return (for speed recognition). In 
response, the protocol emulator prompts you for a terminal type with a message like this: 

ENTER TERMINAL TYPE: 

and you respond with a terminal type, such as: 

ENTER TERMINAL TYPE: Vt-100 

Then a login screen like the one in Figure 13-1 is displayed. The mainframe login screen 
contains fields for the ID and password, which you must fill in. You should send this in¬ 
formation only after the screen is completely painted and the mainframe is waiting for in¬ 
put. This is indicated by the word running somewhere near the lower right comer, as 
shown in the figure. 

When the RUNNING message appears in the lower right, you may type your user ID and 
password, separated by a tab character. As in the linemode example, a couple of carriage 
returns are needed after that. Here is the macro, vmfullogin, that automates the process: 

COMMENT - VMFULLOGIN macro. Arguments: 

; \%1 = User ID 
; \%2 = Password 

define VMFULLOGIN - 

if < \v(argc) 2 end 1 Usage: \%0 userid password,- 
while not defined \%2 { - 

askq \%2 { \%l's password: > - 
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Center for Computing Activities 


Fill in your USERID and PASSWORD and press ENTER 
(Your password will not appear when you type it) 

USERID ===> 

PASSWORD ===> 

COMMAND ===> 

RUNNING CUVMB 


Figure 13-1 Sample IBM 3270 Login Screen 


set input timeout quit,- 
set parity even,- 
set duplex full,- 
set handshake none,- 
set flow xon/xoff,- 
out \13,~ 

inp 5 TERMINAL TYPE:,- 
out vt-100\13,- 
inp 20 RUNNING,- 
pau 1,- 

out \%1\9\%2\13,- 

out \13\13,- 

echo Login successful. 


Quit if INPUT fails 

Set communication parameters 


Send carriage return 
Get terminal-type prompt 
Just send ”vt-100" 

Get RUNNING message 

Wait one second 

Send user ID, tab, password 

Two more carriage returns 


Here again we use SET INPUT TIMEOUT QUIT to keep the macro short and we are careful to 
set all relevant communication parameters. Like our other login scripts, this one works 
with any of the connection-establishment macros. 43 Note that the SET INPUT TIMEOUT 
QUIT command applies only to the current command level (macro or command file) and is 
inherited by those below it. When the VMFULLOGIN macro terminates, the previous INPUT 
TIMEOUT setting is restored. 


43 Except net, because C-Kermit does not, itself, perform 3270 terminal emulation. But if you can 
telnet to a terminal server or protocol converter, or make an X.25 connection to a device, that provides 
3270 emulation, then you can make network full-screen connections after all. 
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Login Scripts for Commercial Data Services 


A very common use of communication software is to log in to commercial information 
services like CompuServe, MCI Mail, or Dow Jones News/Retrieval. In many cases, the 
connection and login procedure is very similar to that for UNIX and VMS: dial the phone 
number, type a carriage return, and then supply your user ID and password in response to 
the prompts. For example, a CompuServe login might look like this: 

C-Kermit> set modem hayes 
C-Kermit >set line /dev/ttya 
C-Kermit >set speed 1200 
C-Kermit >dial 5551212 
Connection completed. 

C-Kermit>connect 
Type CR here 
01NMS 


Host Name: CIS 
User ID: 00000,0000 
Password: _ 

and then you get a greeting, a menu, and the prompt, ending with: 
Enter choice ! 


The login script is straightforward: 


COMMENT - CISLOGIN macro. Arguments: 
; \%1 = CompuServe User ID 
; \%2 = Password 


define CISLOGIN - 

if < \v(argc) 2 end 1 Usage: \%0 userid password,- 
while not defined \%2 { - 

askq \%2 { \%l's password: } - 


1 ,- 

set input timeout quit,- 

output \13,- 

input 5 Host Name:,- 

output cis\13,- 

input 5 User ID:,- 

output \%2\13,- 

input Password:,- 

output \%3\13,- 

input 20 Enter Choice 1,- 

echo Login successful. 


No IF FAILURE'S 
Send initial carriage return 
Look for Host Name prompt 
Send "cis" and carriage return 
Look for User ID prompt 
Send ID and carriage return 
Look for Password prompt 
Send password and CR 
Look for menu prompt 


Sometimes it is preferable to go through a public data network to access the desired ser¬ 
vice, rather than dialing it directly. In the following example, we dial a SprintNet node 
and tell it to connect us to Dow Jones News/Retrieval. 
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C-Kermit> set modem hayes 
C-Kermit> set line /dev/ttya 
C-Kermit> set speed 1200 
C-Kermit> dial 5551212 
Connection completed. 

C-Kermit>connect 
Type CR here 
Type CR here 

TELENET 
212 517A 

TERMINAL-D1 

8 c dow 

DOW CONNECTED 

WHAT SERVICE PLEASE???? 
djnr 

ENTER PASSWORD 

wwwwwwwwwwwwwww 

MMMMMMMMMMMMMMM 
088800800000§§€<Ctr.I -Q> 


(Choose modem type) 
(Communication device) 
(Communication speed) 
(Dial the number) 

(Call is answered) 
(Connect to SprintNet) 


(SprintNet greeting) 

(Enter terminal type) 

(Connect to Dow) 

(Dow greeting) 

(Dow service prompt) 
(Enter "djnr") 
(Password prompt) 


<Ctrl-Q> 


As you can see, the procedure is to type two carriage returns, get a greeting and the 
TERMINAL= prompt, enter Dl, then get the SprintNet g prompt. At this point, you tell it to 
connect (c) you to “dow”. Once you have been put through, Dow asks you which service 
you want. You reply “djnr” (Dow Jones News/Retrieval) and then supply your password 
in response to a rather tricky prompt, which ends with two Ctrl-Q’s separated by some 
spaces. This is quite different from our other examples, because we have to make what 
amounts to two calls, rather than one. The first call is to SprintNet, and the second call is 
from SprintNet to DJNR. Naturally, you can also call other hosts and services from 
SprintNet, and it is conceivable that DJNR can also be reached in other ways besides 
SprintNet. So let’s separate the two functions. 


First, we write the macro that asks SprintNet to call a given service: 

COMMENT - SPRINT macro. Arguments: 

; \%1 = Service name or address 


define SPRINT - 

if < \v(argc) 2 end 1 Usage: \%0 

set input timeout proceed,- 

output \13\13,- 

input 10 TERMINAL=,- 

if fail end 1 No terminal prompt, 

out Dl\13,- 

inp 10 8,- 

if fail end 1 No atsign prompt,- 
output c \%1\13,- 
input 10 CONNECTED, 


service,- 
Use 


IF FAILURE 
Send two CRs 
Get TERMINAL= prompt 
Fail if it doesn't come 
Send terminal type, CR 
Look for atsign prompt 
Fail if it doesn't come 
Connect to service 
Look for confirmation 


if fail end 1 Can't access \%1 from SprintNet 
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Here is the Dow login macro, which can be used after the service has been reached, inde¬ 
pendent of the communication method: 


COMMENT - DOWLOGIN macro. Arguments: 
; \%1 = Dow Jones Password 


/ 

define DOWLOGIN - 

while not defined \%1 { - 

askq \%1 { Dow Jones password: 

input 20 SERVICE PLEASE\?\?\?\?,- 
if fail - 

end 1 No service prompt,- 
out djnr\13,- 
input 10 g @ @ @, - 
if fail - 

end 1 No password prompt,- 
pause 1,- 
output \%1\13,- 
input 20 ENTER QUERY,- 
if fail - 

end 1 No main query prompt,- 
pause 1,- 

echo Login successful. 


; Get password 

> - 

; Look for Dow prompt 


; Select DJNR 
; Get password prompt 


; Wait a second, then... 
; send password and CR 
; Get DJNR query prompt 


The PAUSE commands towards the end of the script allow time for the invisible characters 
(control characters and spaces) to arrive before the password is sent. 


Here is how we use our macros to access DJNR via dialup: 

C-Kermit> call hayes /dev/ttyOl 2400 7418100 
C-Kermit> sprint dow 
C-Kermit> dowloqin 
Dow Jones password: _ 


But suppose you want to use only one macro for logging in to Dow Jones through 
SprintNet, rather than two. Easy. Add this definition to your C-Kermit initialization file: 
define djnrsprint sprint dow, dowlogin 


Finally, let’s consider hosts or services that don’t require any login at all. For these, we 
define a special macro that does nothing: 

COMMENT - NOLOGIN macro. 

/ 

define NOLOGIN comment 

What were these last two items for? Keep reading. 
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A Directory of Services 


Wouldn’t it be nice if you could have one single file that describes all the computers and 
services that you connect to with C-Kermit? One file that would allow you to refer to any 
service simply by name, and Kermit would take care of the connection establishment and 
logging in automatically? A plain text file that is easy to create, read, and modify? 

Let’s design such a file and a series of short macros that use it. For simplicity, let’s call 
the file ckermit.ksd (KSD = Kermit Services Directory) and keep it in our home direc¬ 
tory. In reality, the file can have various names (such as . ksd in UNIX and OS-9) and 
locations. These details are handled in the standard C-Kermit initialization file. Here is 
how our services directory file might look: 

XXVMA vmlinelogin olaf serial /dev/ttyh8 9600 

XXVMB vmfullogin olaf call hayes /dev/cua 2400 765-4321 

CUMIN vmslogin olaf net tcp/ip cumin 

WATSUN unixlogin olaf net tcp/ip watsun.cc.columbia.edu 

COMPUSERVE cislogin 000,0000 call hayes /dev/cua 2400 876-5432 

DJNR djnrsprint xxxx call hayes /dev/cua 2400 741-8100 

GEOGRAPHY nologin xxxx net tcp/ip 141.212.99.9:3000 

CONGRESS nologin xxxx net tcp/ip dra.com 

The file has one line for each service, and each line contains four items: 

1. The name of the computer or service 

2. The name of the macro used to log in to it 

3. Your user ID on the computer or service 

4. The name of the macro used to establish a connection to the computer or service, fol¬ 
lowed by its arguments 

The items in each line are separated by one or more spaces or tabs. Whenever you want to 
add, delete, or modify a service, just use a text editor to make the changes. 

Our job now is to design a macro that lets you access any of these services by name. We 
will call it ACCESS and use it like this: 

C-Kermit> access CompuServe 
C-Kermit> access watsun 
C-Kermit> access djnrsprint 

How might the ACCESS macro work? The straightforward, but less efficient, way would 
be for it to read the services file every time you use it, searching for the service name. 
Let’s try a slightly more complicated but more efficient approach. We will read the ser¬ 
vices file only once, copying it to an internal array that can be searched quickly. 
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First we add the following commands to the C-Kermit initialization file. These commands 
tell Kermit to read the services directory file into an array \&d[ ] whenever you start 
C-Kermit. Let us assume that the C-Kermit initialization file has already assigned the file 
specification of the services directory to the _servicedir variable: 


def max_svcs 50 
set take error off 
if not exist \m(_servicedir) - 
goto noservices 
open read \m(_servicedir) 
if fail - 

end 1 Can't open CKERMIT.KSD 
declare \&d[\m(max_svcs)] 
for \%i 1 \m(max_svcs) 1 { - 
read \&d[\%i],- 
if fail goto done- 


Maximum number of entries 
So we can use IF FAIL 
Have directory? 

No 

Yes, try to open it 
Failed? 

Give message and quit 
Open, declare an array 
Read the entries 
into the array 
Check for end of file 


} 

end 1 Too many entries in directory 


: DONE 

asg \&d[0] \feval(\%i - 1) 
end 0 

:NOSERVICES 
define access - 

echo Services directory not available 
define list - 

echo Services directory not available 


Remember how many 

Finished 

No directory 

So change these commands.., 


In this example, we’re allowing up to 50 entries. If you want to have more, just change 50 
to a bigger number in the first line. Notice that the number of entries actually found in the 
directory is stored in the “zeroth” element of the array, \&d [ 0 ]. 


Next, we define a macro, called LIST, to list the services directory. In the simple form 
shown here, it prints all the entries. A somewhat more flexible version, which also ac¬ 
cepts a service name and lists only that entry, appears in the standard ckermit.ini file. 
Here is the simple version: 

define list echo \&d[0] items in directory:,- 
for \%i 1 \&d[0] 1 { echo \&d[\%i] > 


Which you can use like this: 


C-Kermit>list 


8 items in 

XXVMA 

XXVMB 

CUMIN 

WATSUN 

COMPUSERVE 

DJNR 

GEOGRAPHY 

CONGRESS 


directory: 
vmlinelogin olaf 
vmfullogin olaf 
vmslogin 
unixlogin 
cislogin 
djnrsprint 
nologin xxxx 

nologin xxxx 


olaf 

olaf 

000,0000 

xxxx 


serial /dev/ttyh8 9600 

call hayes /dev/cua 2400 765-4321 

net tcp/ip cumin 

net tcp/ip watsun.cc.columbia.edu 
call hayes /dev/cua 2400 876-5432 
call hayes /dev/cua 2400 741-8100 
net tcp/ip 141.212.99.9:3000 
net tcp/ip dra.com 
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Now we define the ACCESS macro. Its two arguments are a service name and a password: 

COMMENT - ACCESS macro. Arguments: 

; 1 = service name 
; 2 = password (optional) 

} 

define ACCESS - 

if not defined \%1 end 1 access what?,- 
lookup \%1,- 

if success doaccess { \%2} \v(return),- 
else end 1 "\%1" not in service directory, 
if fail stop 1 

The ACCESS macro uses two other macros, which we define in a moment. The lookup 
macro looks up the service name in the service directory. If it is found, the entire direc¬ 
tory entry—that is, the line that starts with the desired name—is returned and assigned to 
the local temporary variable \%9 and the doaccess macro is invoked with the password 
and the directory entry. Otherwise the ACCESS macro fails (STOP l). 

For security reasons, the service directory does not contain passwords. The ACCESS macro 
is designed to accept a password as a second argument after the service name: 

C-Kermit >access CompuServe mypassword 
C-Kermit >acces djnr mypassword 
C-Kermit> acc watsun mypassword 

Notice that the service names can be abbreviated and that passwords echo when you type 
them on the ACCESS command line. You can also omit your password: 

C-Kermit >access compu 
C-Kermit >acces djnr 
C-Kermit> acc wat 

If you omit the password, the LOGIN macro prompts you for it and it does not echo when 
you type it: 

C-Kermit >access watsun 
olaf's password: _ 

When you omit the password, the \%2 argument is undefined. Therefore the access 
macro prepends a space to it before passing it to the DOACCESS macro to ensure that 
DOACCESS will always get a password (even an empty one) as its first argument: 

if def \%9 doaccess { \%2} \%9 

The second argument, \%9, is expanded before it is passed to DOACCESS, so although it 
looks like one argument here, doaccess sees one argument for each word in the directory 
entry. 

Here is the LOOKUP macro. It searches the \&d[ ] array, which contains the services 
directory, one line per array element, and returns the first matching line, or if no matches 
were found, the null (empty) string: 


; Check service 
; Look it up 
; OK, try it 
; Not found 
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COMMENT - LOOKUP macro. Arguments 

; \%1 = Service name to look for in services directory 
define LOOKUP - 

set case off,- ; Case doesn't matter 

for \%i 1 \&d[0] 1 { - ; Loop through services directory 
if eq \%1 \fsubstr(\&d[\%i],1,\flen(\%1)) - ; Compare 

break - 

if not > \%i \&d[0] return \&d[\%i] 

The command: 

if eq \%1 \fsubstr(\&d[\%i],1,\flen{\%1)) 

compares the name that you typed with a substring of each services-directory entry, start¬ 
ing at the first character, with the same number of characters as you typed. If they are 
equal (except for the case of the letters), the BREAK command terminates FOR-loop and 
LOOKUP returns the entire line of text from the directory. 

Finally, here is doaccess. Its purpose is simply to pick apart the words from the services 
directory entry into separate macro parameters and call the connection establishment and 
login macros with them. It is called with a password followed by the services directory 
entry, so the password is argument \%1, the service name is \%2, the login macro name is 
\%3, the user ID is \%4, the connection-establishment macro name is \%5, and the 
connection-establishment macro arguments are \%6 through \%9: 

define DOACCESS - 

asg \%1 \fsubstr(\%l,2) 
do \%5 \%6 \%7 \%8 \%9,- 
if success do \%3 \%4 \%1 

The first command: 

asg \%1 \fsubstr(\%1,2) 

removes the space that was prepended to the password, so now the password is either truly 
empty or else it is the one you typed on the ACCESS command line. The next command: 

do \%5 \%6 \%7 \%8 \%9 

executes the connection-establishment macro from the services directory entry, together 
with its arguments. \%5 is the name of the macro, and the rest are the arguments. If con¬ 
nection establishment is successful: 

if success do \%3 \%4 \%1 

the associated login macro (\%3) is executed, with the user name (\%4) and password 
(\%1) as its arguments. If the password is empty, the login macro prompts you for it. 
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Using the Services Directory 

The ckermit.ini file that comes with C-Kermit 5A already contains all the pieces you 
have read about in this chapter. Just install this file as your own C-Kermit initialization 
file (see Table 2-3 on page 36 for proper name and location). 

Now you should create a ckermit.ksd or .ksd file of your own, using a text editor 
capable of creating plain ASCII text files. Once you have your services directory in place, 
C-Kermit reads it automatically upon startup and then you can log in to any desired com¬ 
puter or service using any connection method available to your computer. Simply type 
access followed by the service name and then supply your password. 


Automated File Transfer 


Establishing the connection and logging in is only the beginning of the story. Once 
logged in to a remote computer or service, you can program Kermit to do automatically 
just about anything that you would do by hand. For example, let’s dial up a remote VMS 
computer, start Kermit there, send a file to it, then log out and hang up. We can easily 
construct a command file out of the building blocks from previous sections. Let’s call it 
SENDOOFA.TAK: 


access cumin 
set input timeout quit 
output kermit\13 
input 5 C-Kermit> 
out server\13 
input 5 READY TO SERVE 
send oofa.txt 
bye 
exit 


; Access a VMS computer 

; Run C-Kermit on VMS 
; Get its prompt 
; Put it in server mode 
; Get READY message 
; Send the file 
; Log out the VMS job 
; Finished 


The first line makes the connection and logs you in. 


Nightly Polling 

Let’s construct a more ambitious example, in which we call up all our franchises at night, 
get their daily reports and inventories, and send them our new recipes. Using the building 
blocks we have already constructed, this is a relatively simple matter. We’ll use our ser¬ 
vices directory for this purpose, which has already been read into memory by the 
C-Kermit initialization file. The list of franchises to be accessed is in another file, which 
we will call FRANCHISES.TXT, and which might look like this: 

Anaheim 

Boston 

Milano 

Moscow 

Nashville 

Paris 
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Stuttgart 

Tokyo 

Each name in this list corresponds to a services directory entry, for example: 

Anaheim vmslogin hg call hayes /dev/cua 2400 1-213-555-0123 
Boston unixlogin hq call telebit /dev/cub 19200 1-617-555-1234 

Here is the script program, written as a command file. Let’s name it nightly . SCR: 


open read franchises.txt ; Open the list of franchises 

if error end 1 Can't open franchises.txt 

open write nightly.log ; Keep a record of what happens 

if error end 1 Can't open nightly.log 

write file Polling franchises: \v(date) \v(time) 


: loop 
read \%a 

if fail goto done 
write file \v(time): calling \%a 
access \%a 
xif fail { - 

write file Can't access \%a.,- 
goto loop - 

} 

output kermit\13 
input 10 > 
output server\13 
pause 2 
get inventory 
xif success { - 

rename inventory inventory.\%a,- 
write file \v(time): got inventory.\%a,- 
} else { - 

write file \v(time): can't get inventory - 

} 

send recipes ; Send the new recipes 

if fail write file \v(time): can't send recipes 
else write file \v(time): sent recipes ok 


Loop for each franchise 
Read a franchise name 
No more left, we're done 

Access the franchise 
Check for failure 


Start Kermit there 
Get its prompt 
Put it in server mode 
Give it time to get ready 
Get the inventory file 


bye 
goto loop 

:done 

write file \v(time): done 
close write 
end 0 


Log out from the franchise 
Go do the next one 

Come here when finished 
Make final log entry 
Close the log 
Succeeded 


To poll the franchises, just start C-Kermit and tell it to take this file: 

$ kermit (Start Kermit) 

C-Kermit> take nightly.scr (TAKE the command file) 
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Passwords and Security versus Automation 


The problem with nightly . SCR is that it prompts you for the password of each franchise 
when the franchise is dialed, which could keep you sitting at the terminal all night! This 
difficulty could be solved easily by including all of the franchise passwords in the 
franchises . txt file, along with the franchise names. But passwords in files pose an 
unacceptable security risk. 

There is no perfect solution to this problem. One approach would be for nightly , SCR to 
read the entire franchises.TXT file into an array before it begins calling the franchises. 
As part of this process, it prompts you for each franchise’s password and stores it in a 
parallel array, as in this example (which allows up to 50 franchises): 

open read franchises.txt ; The list of franchises 

if error end 1 Can't open franchises.txt 

define n franchises 50 ; Change if you need more 

declare \&f[\m(n_franchises)] ; Array for franchise names 

declare \&p[\m(n_franchises)] ; Array for passwords 

for \%i 1 \m(n_franchises) 1 { - 
read \&f[\%i], - 
if fail break, - 

askq \&p[\%i] Password for \&f[\%i]: - 

} 

close read ; Close the file 

decrement \%i ; Number of entries 

assign \&f[0] \%i ; Record it here 

Notice the use of ASKQ to request the passwords without echoing them. It is unsafe to 
echo passwords; someone might be spying on your terminal. 

Now you can change the main loop of NIGHTLY.SCR into a counted loop, from 1 to 
\&f [0], and when you access a franchise, you can provide both the service name and 
the password: 

access \&f[\%i] \&p[\%i] 

There are drawbacks to this approach. First, you still have to type the whole list of 
passwords every night, a tedious and error-prone process, especially when they don’t 
echo! If you make a typographical error in a franchise password, NIGHTLY.SCR will not be 
able to access the franchise and business can suffer. 

Second, we have not really removed the security risk. The passwords are in an array in 
Kermit’s memory for as long as nightly.scr is running. A computer-literate burglar 
could break in after you leave, interrupt Kermit, and have it display the two arrays with a 
few simple keystrokes: 

Ctrl-C *C.. . 

C-Kermit> for \%i 1 \&f[0] 1 { echo \&f[\%i1: \&pr\%i1 > 
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Encryption 

A second method is to store the franchise names and passwords together in the 
franchises . TXT file, but to encrypt the file with an encryption key known only to your¬ 
self. First, create the file in plain text. Each line has the name of a franchise (correspond¬ 
ing to a name in your services directory) and the password, separated by one or more 
spaces. Suppose your franchises . TXT file now looks like this: 


Anaheim 

Boston 

Milano 

Moscow 

Nashville 

Paris 

Stuttgart 

Tokyo 


goofy 

beans 

bongiorno 

priwjet 

howdy 

pernod 

gruessgott 

saki 


If it does, you’re already in trouble! Before you start worrying about how to make your 
C-Kermit script more secure, rush to the phone, call up your franchises, and have them fix 
their passwords to be harder to guess. Random combinations of upper- and lowercase let¬ 
ters and digits are recommended, as well as punctuation marks if the system allows them. 


The rest of this section is aimed at UNIX users. We’d have said this earlier, but we 
wanted you to read about passwords first. This is the 90s! 


Assuming your passwords are not easily guessable, encrypt the franchises.txt file 
with the UNIX crypt program and then remove the plain-text version: 

$ crypt keyword < franchises.txt > franchises.x 
$ rm franchises.txt (Delete the original) 

$ mv franchises.x franchises.txt (Rename) 

The keyword is your encryption key, a string of characters that, like a password, should 
not be easily guessable. If you want to decrypt the file, just give the same crypt com¬ 
mand again with the same keyword. For example, to view the file on your screen: 

$ crypt keyword < franchises.txt 

Now modify NIGHTLY.SCR to prompt you for the encryption key and then read the 
encrypted file through the crypt program. Now you only have to type in one password in¬ 
stead of many. This mitigates the consequences of both error and theft. Note that the key 
stays in Kermit’s memory for only a brief instant, presumably while you are still present 
and en garde: 

askq \%8 Encryption key: ; Ask for key 

open tread crypt \%8 < franchises.txt ; Read file through crypt 

if fail end 1 Can't decrypt franchises.txt 

define \%8 ; Erase key from memory 
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But what if you make a typographical error when entering the key? The entire nightly 
polling run would be wasted. You can avoid this by adding commands to check the key 
by displaying the first few lines of the FRANCHISES.TXT file: 

:GETKEY 

askq \%8 { Encryption key: > ; Ask for key 

run crypt \%8 < franchises.txt | head ; Display a few lines 
getok { Is this correctX? } ; Make sure key is correct 

if fail goto getkey ; If not, try again 

We get past this loop only when a working encryption key has been entered. 

Next we modify nightly . SCR to make it as secure as possible. All the commands that 
deal with login passwords are moved into a macro, and we keep the login password in a 
temporary variable local to the macro, an unused macro argument. Should burglars inter¬ 
rupt C-Kermit, all local temporary variables are automatically erased from memory before 
the prompt returns. 

Here is the secure version of the nightly . SCR file, for UNIX only. 


COMMENT 


File NIGHTLY.SCR, nightly franchise-polling program. 


define GETNAME - 

assign franchise \%1 

define SECUREACCESS - 
read \%9,- 
if fail goto done,- 
getname \%9,- 
write file - 


\v(time): calling \m(franchise)\10,— 


Macro to extract service name 
from franchises.txt entry 

Secure wrapper for ACCESS 
Read a line from franchises.txt 
If none left, we are done 
Get service name 
Make a log entry 


Access <name> <password> 


access \%9,- 
xif fail { - 

write file Can't access \m(franchise)X10,- 
goto loop - 

> 


COMMENT - Program begins here. 

7 

open write \v(ndate).log ; Start a log file 

if fail - 

end 1 Can't write \v(ndate).log 

:GETKEY ; Encryption key section 

askq \%8 { Encryption key: } ; Ask for encryption key 

7 

; Use UNIX "head" program to display the top of the file 
; and ask whether it looks right. 

7 

run crypt \%8 < franchises.txt | head ; Display a few lines 
getok { Is this correctX? > ; Ask if they look OK 

if fail goto getkey ; If not, try again 
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; We have the encryption key. Open and read the franchises file. 


open Iread crypt \%8 < franchises.txt 
assign \%8 \v(status) 
if not = \%8 0 - 

end 1 Can't read franchises.txt 


; Read & decrypt file 
; Get status, erase key 
; Check status 


write file Polling franchises: \v(date) \v(time)\10 


Loop for each franchise 
Access next franchise 
Start Kermit there 
Get its prompt 
Put it in server mode 
Give it time to get ready 
Get the inventory file 


:LOOP 

secureaccess 
output kermit\13 
input 10 Kermit> 
output server\13 
pause 2 
get inventory 
xif success { - 

rename inventory inventory.\m(franchise),- 
write file \v(time): got inventory.\m(franchise)\10,- 
} else { - 

write file \v(time): can't get inventory from \m(franchise)\10 - 

} 

send recipes ; Send the new recipes 

if fail write file \v(time): recipes NOT sent to \m(franchise)\10 
else write file \v(time): recipes sent to \m(franchise)\10 


bye 

goto loop 


Log out from the franchise 
Go do the next one 


:DONE 

write file \v(time): done\10 
close write 
end 0 


Come here when done 
Make final log entry 
Close the log 
Succeeded 


To run this secure version of NIGHTLY.SCR, an additional security is required; rather than 
typing: 

C-Kermit> take nightly.scr 
define a macro to take the command file: 

C-Kermit> define nightly take nightly.scr (Define the macro) 
C-Kermit> niqhtly (and execute it) 

This way the variable \%8, which briefly holds the encryption key, is safe from program 
interruption. Should anyone Ctrl-C the program at a crucial moment—for example while 
it is asking “Is this correct?”—the key disappears from memory automatically. 

Remember, however, that no computer program can be totally secure; not our script 
program, not C-Kermit itself, not the underlying operating system or its utilities. While it 
is always better to take precautions like those we have used here, it is also wise not to 
have too much faith in them. 
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The SCRIPT Command 


The SCRIPT command is shorthand for a series of INPUT and OUTPUT commands, allowing 
an entire login script to be executed in a single short (but cryptic) command. Strictly 
speaking, the script command is not needed. There is nothing it can do that cannot be 
done by the methods already described. The script command has been a part of 
C-Kermit since 1985 and is carried forward for compatibility with previous releases. The 
other programming features described in this and the previous chapters are new to 
C-Kermit version 5A. 

A SCRIPT consists of a series of expect and send strings, separated by spaces. Kermit 
waits for the first expect string; when it comes Kermit sends its first send string and then 
waits for its next expect string, and so on: 

SCRIPT expect send [ expect send [...]] 

Executes the given series of expect and send strings. If an expect string does not 
arrive, the command fails. If all the expect strings arrive, the command succeeds. 

The send and expect strings can contain special sequences prefixed by tilde (-), listed in 
Table 13-1 on the next page. Most of these can also be adequately represented by 
Kermit’s normal backslash codes. 

Kermit automatically includes a carriage return at the end of each send string unless it 
ends with -c. Only the last seven characters in each expect are matched. A null expect, 
-0 or two adjacent dashes, causes a short delay before proceeding to the next send se¬ 
quence. A null expect always succeeds. 

If there is a chance that an expect sequence might not arrive, you can express conditional 
sequences in the form: 

-send-expect[-send-expect[...]] 

where dashed sequences are followed until an expect succeeds. For example, on a noisy 
connection: 

script -0 login\32olaf-ssword:-login\32olaf-ssword: 

sends “login olaf” followed by a carriage return. If the Password: prompt does not arrive 
within the default timeout interval, “login olaf” is sent again. 

expect-send transactions can be debugged by logging transactions (LOG TRANSACTIONS). 
This records all exchanges, both expected and actual. The script execution is also logged 
in the session log, if that is activated. 

Script execution can be interrupted by typing your interrupt character, normally Ctrl-C. 
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Table 13-1 Notation for SCRIPT Command 


Notation 

Description 

-b 

Backspace (you can also use \8) 

-s 

Space (= \32) 

-q 

Question mark (= \?) 

~n 

Linefeed (= \10) 

~r 

Carriage return (= \13) 

-t 

Tab (= \9) 

— 

Tilde (= \ 12 6) 

~x 

XON (Control-Q) (= \17) 

-c 

Don't append a carriage return to a send string. 

~n[n[n]] 

Octal representation of an ASCII character code (= \onnn) 

-0 

(zero) When used as an expect string, this means “expect nothing” and proceed 
immediately to the next send string. When used by itself as a send string, it means to 
send nothing followed by a carriage return. 

~d 

Delay approximately 1/3 second during send. 

I 

1 

Wait the specified number of seconds during expect, then time out. The default 
waiting interval is 15 seconds. 


The progress of a SCRIPT command is normally displayed on your screen, but you can 
control the display with the following command: 

SET SCRIPT ECHO { ON, OFF } 

Controls whether the characters sent and received during script execution are to be 
echoed on your screen. The default, ON, echoes the characters. 

Here is an example in which the script command is used to log in to a VMS computer, 
similar to our vmslogin macro from page 287: 

script -0 -0 name:—name: \%1 word: \%2 \27Z \27[\?lc $—$—$ 

In this example, we expect nothing, then send a carriage return, then wait for name: from 
the Username: prompt. If we don’t get it, we send another carriage return and wait for it 
again. If we get it, we send our username (which is contained in the variable \%1), then 
wait for the Password: prompt. If it comes, we send our password \%2, wait for the ter¬ 
minal ID query, send a VT100 terminal ID, then wait for the VMS dollar sign prompt. If 
it doesn’t come, we send a carriage return and wait again, and so on. The example 
demonstrates how a single script command can replace a long series of output, input, 
and if success commands, accomplishing the same actions in a more compact (and more 
cryptic) form. The SCRIPT command, however, does not allow intermixture of expect-send 
items with regular Kermit commands such as SET PARITY, SEND, RECEIVE, and so on, but 
script commands themselves can be intermixed with any other C-Kermit commands. 
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Script Programming Ideas 

This chapter describes only a few of the many applications for C-Kermit’s script program¬ 
ming language. If you have the urge to program, here are some other ideas that might in¬ 
terest you: 

1. Define a capture macro that simplifies the job of using LOG session to capture a file 
from a remote host or service that does not have the Kermit protocol. 

2. Construct a newdial macro that supports a new type of modem that is not directly 
supported by C-Kermit’s built-in dial command. HINT: use SET car rier off before 
SET LINE, and then SET CARRIER AUTO after dialing. 

3. Change the CALL macro to accept a list of phone numbers, rather than just one. If a 
call fails, have it try the next number in the list. This is useful for calling services that 
can be reached at several different phone numbers. 

4. If you have a multiuser computer with several shared dialout devices, try modifying 
the call macro to search for the first one that is not in use, rather than giving up right 
away if the given device can’t be used. 

5. Test your modem pool. Read a list of phone numbers from a file, dial them all up, 
monitor whether they answer or not, and summarize the results in a report file. 

6. Check your network hosts. Write a script that SETs HOST to the computers on your 
network, and keeps a log of which ones were reachable and which ones were not. 

7. Check your network gateways. Write a script that logs in to each of your gateways 
and gathers statistics about their use, and appends the statistics report to a log file that 
can be read by other programs to produce usage summaries or graphs. 
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Chapter 14 


Command-Line Options 


Until now, you have communicated with C-Kermit interactively : you start Kermit, Kermit 
issues its prompt, you give it a command, it issues another prompt, and so on until you 
EXIT from the program. In some circumstances, however, you might want to—or be re¬ 
quired to—give Kermit its commands as part of the system command that starts it. The 
following example shows an alternative way of telling Kermit to send the file oofa.exe 
in binary mode using even parity: 

$ kermit -i -p e -s oofa.exe 

The command with which you start Kermit is called the command line. Any items in¬ 
cluded after the program’s name on the command line are called command-line options. 
Command-line options can be useful for various reasons: 

1. Certain UNIX C-Kermit programs are configured for command-line operation only. 
This must be done for systems, primarily 286-or-lower PCs that have limited address 
space, or compilers or linkers that are not capable of building an interactive version. 

2. Interactive program dialog might be unfamiliar to some UNIX users. In UNIX, most 
applications are invoked by giving their names and possibly some operands, and they 
automatically exit back to the UNIX prompt without any dialog when done. 

3. In UNIX, you might want to use Kermit in a command pipeline, sending files from 
standard input or receiving them to standard output, for example to transfer a file in 
compressed and/or encrypted form between two UNIX systems. 

4. You might want to change Kermit’s normal startup actions, for example specifying a 
different initialization file or no initialization file at all. 
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A selection of C-Kermit commands is available on the command line in environments that 
support passing of command-line options to programs through the C-language “argv, 
argc” mechanism [46], provided that Kermit has been configured to use them. In VMS, 
Kermit must be installed as a foreign command so VMS will make the command line op¬ 
tions available to Kermit, for example: 

KERMIT :== $SYS$SYSTEM:KERMIT.EXE 

Command-line options allow you to define convenient command macros or aliases for 
starting Kermit in certain ways. For example, using the UNIX K-Shell [5], you could 
define aliases like these in your . env file: 

alias "kr=kermit -r" # to receive files, just type 'kr' 

alias "ks=kerinit -s" # to send text files, type 'ks filename' 

alias "kb=kermit -is" # to send binary files, type 'kb filename' 

C-Kermif s command-line options conform to the normal UNIX conventions [33]: 

• Command names (like “kermit”) must be between 2 and 9 characters long. 

• Command names must include lowercase letters (in UNIX) and digits only. 

• An option name is a single character. 

• Options are delimited by “ for example “ -q -z”. 

• Options with no arguments may be grouped (bundled) behind one delimiter, for ex¬ 
ample “ -s oofa.txt -qt”. 

• Option-arguments cannot be optional. 

• A group of bundled options may end with an option that has an argument, for example 
“ -qzs oofa.txt”. 

• Arguments immediately follow options, separated by whitespace. 

• The order of options does not matter. 

• preceded and followed by whitespace means standard input. 

C-Kermit’s command-line options are summarized in Table 14-1. 
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Table 14-1 C-Kermit Command-Line Option Summary 


Option 

Argument 

Action 

Description 

= 


N 

Ignore the rest of the command line 

-a 

filename 

N 

As-name for transferred file 

-b 

number 

N 

Transmission rate, bits per second 

-C 

" command-list " 

N 

Interactive-mode Kermit commands to execute 

-c 


Y 

connect before file transfer 

-d 


N 

Create a debugging log file, DEBUG.LOG 

-e 

number 

N 

Set receive packet-length 

-f 


Y 

Send a finish command to a Kermit server 

-g 

filespec 

Y 

Send a GET command to a Kermit server 

-h 


Y 

Print a help message listing the command-line arguments 

-i 


N 

Binary file transfer 

-j 

host 

N 

TCP/IP host name or address 

-k 


Y 

Receive to standard output 

-1 

device-name 

N 

SET line to specified serial device 

-m 

modem-type 

N 

SET MODEM to specified modem type 

-n 


Y 

connect after file transfer 

-o 

number 

N 

X.25 closed user group number 

-p 

letter 

N 

Parity: e(ven), o(dd), m(ark), s(pace), or n(one) 

-q 


N 

Quiet mode, suppress messages and file transfer display 

-r 


Y 

receive files 

-s 


N 

Stay, enter command mode even if action options specified 

-S 

filespec 

Y 

send files 

-t 


N 

Local echo, XON handshake for file transfer 

-u 

text 

N 

Specify X.25 call user data 

-u 


N 

Specify X.25 reverse-charge call 

-V 

number 

N 

Specify file transfer sliding window size 

-w 


N 

Incoming files write over existing files with same name 

-X 

number 

N 

Specify an X.25 host (X.121) address 

-X 


Y 

Enter server mode 

-Y 


N 

Do not execute the initialization file 

-y 

filename 

N 

Execute filename instead of the normal initialization file 

-z 

number 

N 

Specify the file descriptor of an open X.25 connection 

-Z 


N 

Force foreground operation 
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Option List 


C-Kermit’s command-line options fall into two categories: action options and non-action 
options. If you give one or more action options on the command line, C-Kermit exits after 
performing them, returning an appropriate exit status code to your system’s command 
processor (shell, DCL, etc.), unless you also specified the -s (uppercase) “Stay” option. 
If your command-line includes no action options, C-Kermit issues its prompt after execut¬ 
ing the command-line options. The action options are primarily those for entering 
CONNECT mode and for transferring files. The non-action options correspond mostly to 
set commands. 

In VMS, uppercase options must be enclosed in doublequotes to prevent them from being 
converted to lowercase before C-Kermit sees them. 


Program Management Options 

The first group of options is concerned with program management: 


-h Help. Action option. Displays a brief synopsis of the command line options. 
Example: 

$ kermit -h 


-y filename 

Executes commands from the specified file instead of the standard initialization file. 
Applies only to interactive versions. Examples: 


% kermit -y /usr/olga/special.ini 
$ kermit -y sys$login;special.ini 
) kermit -y ;udd:olga;special.ini 
F:\> kermit -y c;\kermit\special.ini 


(UNIX) 

(VMS or OpenVMS) 
(AOS/VS) 

(OS/2) 


-Y (uppercase Y) Do not read or execute any initialization file. Applies only to inter¬ 
active versions. Examples: 

$ kermit "-Y" (VMS - Note doublequotes) 

% kermit -Y (Elsewhere) 


filename 

If the first item on C-Kermit’s command line is a filename, C-Kermit executes com¬ 
mands from the named file after it finishes the initialization file, if any. Applies only 
to interactive versions. Example: 

% kermit sendmyfiles 

In UNIX only, C-Kermit command files can be constructed to be run as if they were 
programs, starting C-Kermit automatically. To do this, include a line like the follow¬ 
ing as the first line of the command file: 

#1/usr/local/bin/kermit 
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where /usr/local/bin/kermit is the full pathname of the Kermit program on 
your computer. Add execute permission to the command file: 

% chmod +x sendmyfiles 

and then you can run it as if it were any other UNIX command, program, or shell 
script: 

% sendmyfiles 

In VMS, you can define convenient aliases to run Kermit easily with different com¬ 
mand files, by using VMS’s define command, for example: 

$ define CompuServe $sys$system:kermit.exe sys$login:compuserve.cmd 
$ define sprintnet $sys$system:kermit.exe sys$login:sprintnet.cmd 

C "command, command, ..." 

(uppercase C) Executes the interactive-mode commands after the initialization file (if 
any), the other command-line options (if any), and the command file (if any). Applies 
to interactive versions only. The command list must be enclosed in doublequotes, 
with commands separated by commas. Examples: 

$ kermit "-C" "set block-check 3, send oofa.txt" (VMS) 

$ kermit -C "set block-check 3, send oofa.txt" (Elsewhere) 

This option lets you give any commands at all to C-Kermit from the command line. 

The maximum length of the command line is your operating system’s command line 
buffer size. The maximum length for the command-list is 1024. 

When you use the -C option, the command list is assigned to a macro called 
CL_COMMANDS (command-line commands), so you can also execute these commands 
later during your session simply by typing the name of this macro: 

C-Kermit> cl commands 

The -c option is not considered an action option, even if the command list contains 
action commands. Therefore, if there are no other action commands among the 
command-line arguments, the C-Kermit prompt appears when the last command in the 
list has finished executing. To defeat this behavior, include exit as the last command, 
as in this example, which uses all the power of C-Kermit to clear a VT100 terminal 
screen: 

kermit -C "echo \27[2J\27H, exit” 

The -C option is available only if C-Kermit includes the script programming language; 
that is, if it has a DEFINE command. 

q Quiet. Suppresses screen messages during local-mode file transfer as well as most 
other screen writing. This option is used to allow a file transfer to take place in the 
background. It is equivalent to the interactive-mode command SET QUIET ON. 
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-z Force foreground operation. Even if Kermit thinks it is running in the background, it 
should behave as if it were in the foreground, issuing its normal prompts and mes¬ 
sages, and so on. You can use this option whenever you start C-Kermit in some un¬ 
usual way and its prompt fails to appear. It is equivalent to the interactive-mode com¬ 
mand SET BACKGROUND OFF. 

-d Debug. Equivalent to the interactive-mode command LOG debug. Records debug¬ 
ging information in the file DEBUG.LOG in the current directory. Use this option if you 
believe Kermit is misbehaving, and show the resulting log file to your local Kermit 
maintainer. 

-S (uppercase S) Stay. This option tells C-Kermit to issue its prompt and enter inter¬ 
active command mode even if the command line included action options. Applies to 
interactive versions only. Examples: 

$ kermit -s oofa.txt 11 -S" (VMS or OpenVMS) 

$ kermit -r -a oofa.txt -S (Elsewhere) 

= text 

Tells C-Kermit to ignore all command-line options that follow but (in an interactive 
version of C-Kermit that includes the script programming feature) make them avail¬ 
able, along with all the other items from the command line, in the array \&@ []. In 
VMS, this option must be enclosed in doublequotes if it is the first option. Examples: 
$ kermit -2 = this is some text (Anywhere) 


$ 

kermit this is some text 

(VMS or OpenVMS) 

$ 

kermit = this is some text 

(Elsewhere) 


Communications Options 

These are the options for selecting and configuring your communication device. You 
won’t need any of these, except perhaps -p, if you are using C-Kermit in remote mode. 

-1 device 

Specifies a serial communication device to use for file transfer and terminal connec¬ 
tion. Equivalent to the set line command (see page 43). Examples: 

% kermit -1 /dev/ttyi5 (UNIX) 

$ kermit -1 txa5: (VMS or OpenVMS) 

) kermit -1 §con5 (AOS/VS) 

C:\> kermit -1 coml (OS/2) 

You can also give a numeric file descriptor for a serial communication (tty) device 
that is already open: 

$ kermit -1 6 

This is useful for starting Kermit from some other communication software that al¬ 
ready has opened the device. 
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When a serial communication device is being used, you also need some additional options 
for successful communication: 

-b number 

Bits per second. Specifies the transmission speed in bits per second (“baud rate”) for 
the serial communication device given in the -1 option, as in: 

$ kermit -1 /dev/ttyi5 -b 9600 

This option, equivalent to the SET SPEED command (p. 44), should always be included 
with the -1 option since the speed of a device is not necessarily what you expect. 

-p letter 

Parity. Selects the type of parity for use on the selected communication device. The 
argument is a single letter, e, o, m, s, or n, identifying the type of parity: even, odd, 
mark, space, or none. The default is n, none. Equivalent to set parity (page 89). 

-t Specifies local echoing during CONNECT mode and half-duplex line turnaround with 
XON as the handshake character during file transfer. Used for communicating with 
IBM mainframes in linemode. Equivalent to SET TERMINAL ECHO ON (page 89) and 
SET HANDSHAKE XON (page 127). 

-m name 

Modem type: hayes, penril, vadic, etc. (see Table 3-2 on page 53). Use this option in 
conjunction with the -1 and -b options if you want to use C-Kermit to dial out. If you 
don’t specify a modem type, and the modem is not asserting the carrier signal, Kermit 
might not be able to open the device given in the -1 option. The modem name must 
be given in lowercase, but can be abbreviated, e.g. “hay” for “hayes.” Equivalent to 
SET MODEM (page 51). Example: 

$ kermit -m telebit -1 /dev/cub -b 2400 
You can also use the -C option to include a dialing command: 

$ kermit -m telebit -1 /dev/cub -b 2400 -C "dial 7654321" 

If you want to use a network connection (see pages 67-77) rather than a serial terminal 

device for communication, use the following options rather than -1, -b, and -m. Parity is 
usually not required. The speed (-b) option has no effect on network connections. 

-j host 

Host. Specifies a TCP/IP network host. Equivalent to the SET NETWORK TCP/IP and 
SET HOST commands. The host can be an IP host name, an IP host number (containing 
dots), or either one of these followed by a colon and then a TCP service name or num¬ 
ber (the default service is 23, which is TELNET). The following examples all connect 
to the TCP TELNET port on the same host: 

$ kermit -j kermit.columbia.edu 

$ kermit -j kermit.columbia.edu:23 
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$ kermit -j kermit.Columbia.edu;telnet 
$ kermit -j 128.59.39.2 
$ kermit -j 128.59.39.2;23 
$ kermit -j 128.59.39.2:telnet 

If you get a message like: 

?Invalid argument, type 'kermit -h' for help 

it means your Kermit version was not built with TCP/IP network support. 

The following example connects to a non-TELNET information server: 

$ kermit -j martini.eecs.umich.edu:3000 

The host field can also be just a number, in which case it is assumed to be a file 
descriptor for an open TCP/IP telnet connection: 

$ kermit -1 4 

For X.25 connections only, you also have four additional options: 

-X address 

(uppercase X) X.25 address. Specifies an X.25 network address. 

-z number 

(uppercase Z) X.25 file descriptor. Specifies a file descriptor for an X.25 connection 
that is already open. 

-o index 

X.25 closed user group call. 

-u X.25 reverse-charge call. 

Here are C-Kermit’s terminal connection options: 

-c Establishes a terminal connection over the communication device before any Kermit 
protocol activity takes place. Get back to your local computer by typing the escape 
character (normally Control-Backslash) followed by the letter c. A communication 
device must also be specified. Equivalent to the connect command (page 79). 
Examples: 

% kermit -1 /dev/ttyal -b 2400 -c (UNIX) 

$ kermit -1 txa4: -b 1200 -c (VMS or OpenVMS) 

C;\> kermit -1 com2 -b 9600 -c (OS/2) 

$ kermit -j watsun.cc.columbia.edu -c (Network) 

-n Like -c, but after Kermit protocol activity; -c and -n may both be used in the same 
command line. For example, the -c option lets you connect to the other computer, log 
in, and start a file transfer, and the -n option lets you connect back after the file trans¬ 
fer and log out. 
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File Transfer Options 

The following command-line options are available to perform C-Kermit’s basic text and 
binary file transfer operations, described fully in Chapters 5-8: 

-s file spec 

Send. Action option. Sends the specified file or files to a Kermit program that is in 
RECEIVE or SERVER mode. In UNIX, if filename contains wildcard (meta) characters, 
the UNIX shell expands it into a list of filenames. The filespec can also be a list of 
files, as in: 

kermit -s ckcmai.c ckuker.h oofa.txt 

Thus, this option is equivalent to the interactive-mode command MSEND. If the 
filename is - (a hyphen), Kermit sends from its standard input, which may come 
from a file: 

kermit -s - < foo.bar 
or piped in from a process: 

Is -1 | grep Tokyo | kermit -s - 

You cannot use this mechanism to send characters from your terminal’s keyboard. If 
you want to send a file whose actual name is -, you can precede it with a path name, 
as in: 

kermit -s ./- 

To use standard input as a source for sending files in VMS, you must redefine 
SYS$INPUT to be the desired file, for example: 

$ define sys$input loqin.com 
$ kermit -s 
$ deassign sys$input 

Note that the final hyphen must be quoted; otherwise VMS interprets it as a DCL 
command-continuation character. 

-r Receive. Action option. Waits passively for files to arrive from another Kermit 
program, which must be told to send the file(s). This option is equivalent to the 
receive command. 

-k Receive to standard output. Action option. Receives a file or files from another Ker¬ 
mit, which must be told to send the file(s), and writes them to standard output. This 
option can be used in several ways: 

kermit -k 

Displays the incoming files on your screen; to be used only in local mode. 
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kermit -k > filename 

(UNIX and other operating systems that support standard-output redirection via 
the > operator) Sends the incoming file or files to the named file, filename. If 
more than one file arrives, all are concatenated together into the single file, 
filename. 

kermit -k | command 

(UNIX and other operating systems that support command pipelines via |) Pipes 
the incoming file or files to the indicated command, as in: 

kermit -k | sort > sorted.stuff 
-a filename 

As-name. If you have specified a file transfer option, you may give an alternate name 
for a single file with the -a option. For example, 

kermit -s foo -a bar 

sends the file foo, telling the receiver that its name is bar (“send foo as bar”). If 
more than one file arrives or is sent, only the first file is affected by the -a option: 
kermit -ra baz 

stores the first incoming file under the name baz and any others under their own 
names. 

-x Server. Action option. Become a Kermit server. This is equivalent to the SERVER 
command. 

Here are the options for sending commands to Kermit servers: 

-g remote-filename 

Get. Action option. Actively requests a Kermit server to send the named file or files; 
remote-filename is a file specification in the remote host’s own syntax. In UNIX, if 
remote-filename happens to contain any special shell characters, like space, *, 
etc., these must be quoted using the UNIX shell’s quoting mechanisms, as in: 
kermit -g x\*.\? 
or: 

kermit -g "profile exec" 

The -g option is equivalent to the get command. 

-f Finish. Action option. Sends a finish command to a remote server, equivalent to the 
finish command. 

The command line may contain no more than one protocol action option; that is, only one 
of these: s, r, x, g, f, or k. 
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The following modifier options can be included with file-transfer action options: 

-i Binary mode; equivalent to the set file type binary command. Specifies that files 
should be sent or received with no conversions. See Chapter 5. 

-w Writeover. If an incoming file has the same name as an existing file, it replaces the 
existing file. This changes the default behavior, which is to preserve the old file by 
changing the name of the existing file before creating the new one. Equivalent to SET 
F IL E COLLISION OVERWRITE. 

-e number 

Receive packet-length. Specifies that C-Kermit is allowed to receive packets up to the 
specified length, between 10 and some large number, like 1,000 or 2,000, or even 
9,000, depending on how C-Kermit was configured. The default maximum length for 
received packets is 94. Packets longer than 94 are used only if the other Kermit sup¬ 
ports and agrees to use the long packet protocol extension. This command is equiv¬ 
alent to SET RECEIVE PACKET-LENGTH. 

-v number 

Window size. Specifies that C-Kermit is allowed to send and receive files using a 
window size up to the given number. Window sizes greater than 1 speed up transfers 
in most situations, especially long-distance network connections. The default window 
size is 1, the maximum is 31. Sizes greater than 1 work only if the other Kermit sup¬ 
ports this option and has been told to use it. Equivalent to the SET window command. 

Command-Line Examples 


kermit -1 /dev/ttyi5 -b 1200 -rcn 

This command connects you (the c in -rcn) to another computer through the ttyi5 
device at 1200 bps, where you presumably log in, run Kermit, and give it a SEND com¬ 
mand. After you escape back, C-Kermit waits for a file (or files) to arrive (the r in 
-rcn). When the file transfer is complete, you are reconnected (the n in -rcn) to the 
remote system so you can logout. This example illustrates the principles that the order 
of options does not matter and that options with no arguments can be grouped. 

kermit -1 /dev/ttyi5 -b 1200 -cntp m -r -a foo 

This command is like the preceding one, except the remote system in this case uses 
half-duplex communication (the t in -cntp) with mark parity (-.. .p m). This il¬ 
lustrates how the final option (p) in an option bundle -cntp can take an argument. 

The first file that arrives is stored under the name foo (-a foo). 

kermit -ix 

This command starts up C-Kermit as a server (note the bundling of the options -i 
and -x). Files are sent in binary (image) mode. 
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kermit -1 /dev/ttyi6 -b 9600 

This command sets the communication line and speed. Since no action is specified, 
C-Kermit issues a prompt and enters an interactive dialog with you. Any settings 
given on the command line remain in force during the dialog, unless explicitly 
changed. 

kermit 

This command starts up Kermit interactively with all default settings. 

The next example shows how UNIX C-Kermit might be used to send an entire directory 
tree from one UNIX system to another, using the tar (tape archive) program as Kermit’s 
standard input and output. On the originating system, in this case the remote, type (for 
instance): 

tar cf - /usr/olga | kermit -is - 

This causes tar to send the directory /usr/olga (and all its files and all its subdirectories 

and all their files_) to standard output rather than to a tape; C-Kermit receives this as 

standard input and sends it as a binary file. On the receiving system, in this case the local 
one, type (for instance): 

kermit -il /dev/ttya -b 9600 -k | tar xf - 

Kermit receives the tape archive and sends it via standard output to its own copy of tar, 
which extracts from it a replica of the original directory tree. 

This example shows how the UNIX compression utility might be used to speed up Kermit 
file transfers between two UNIX computers: 

kermit -cnikl /dev/cua -b 9600 | uncompress > foo (local receiver ) 
compress < file | kermit -is - ( remote sender) 

And the final example combines the previous two to give you the fastest serial line backup 
ever: 

kermit -cnil /dev/ttya -b 9600 -k | uncompress | tar xf - 
tar cf - /usr/olga | compress | kermit -is - 
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Appendix I 


C-Kermit Command Reference 


When you start C-Kermit, it performs commands in this order: 

1. The -d command-line option, if any. 

2. The initialization file. If -y (uppercase) was used, the initialization file is skipped. If 
-y (lowercase) was used to specify an alternative initialization file, it is executed in¬ 
stead of the standard file. 

3. If a filename was given as the first command-line argument, the commands in that file. 

4. Command-line options (except -y and -C), if any. 

5. The command list given in the -c command-line option. 

6. Interactive commands if no action commands were given on the command line, or if 
action commands were given and the -S option was included on the command line. 

The interactive commands in (6) include commands piped in or redirected from files, in 
which case Kermit exits upon the end of the file. For truly interactive operation from the 
keyboard, Kermit keeps prompting you until you type the EXIT or QUIT command. 

When C-Kermit exits, it returns a numeric code that can be tested by batch files, shell 
scripts, etc. The values are shown in Table 1-1. A nonzero return code can be the sum of 
any combination of these values; for example, a code of 6 means both a send and a 
RECEIVE command failed. The return codes that C-Kermit supplies automatically can be 
overridden by supplying a return code with the EXIT or QUIT command. 
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Table 1-1 C-Kermit Return Codes 


Code 

Meaning 

0 

Overall success 

1 

A program error occurred 

2 

A SEND command failed 

4 

A receive command failed 

8 

A remote command failed 


Command Summary 

This section lists C-Kermit’s commands alphabetically, with the syntax notation described 
in Chapter 2, and with concise descriptions of their actions. All commands set the 
SUCCESS or failure flag for explicit testing by the IF SUCCESS and IF failure commands, 
as well as implicit testing by the command file reader (according to SET take error) and 
the macro expander (set MACRO ERROR), unless otherwise noted. 

Variables, functions, and other quantities introduced by backslash (\) are fully evaluated 
before a command is executed, except in fields that require variable-names or unless 
otherwise noted. C-Kermit’s backslash codes are summarized in Table 1-2 on p. 325, 
built-in variables are listed in Table 1-3 on p. 326, and built-in functions are listed in Table 
1-4 on p. 327. File transfer interruption characters are listed in Table 1-5 on p. 328. 

; (followed by at least one space) 

Introduces a comment. Chapter 2. Synonym: #. 

! [ command ] 

Runs the local host operating system command or program denoted by command. If 
no command is given, the local system’s command processor is entered in such a way 
that exiting from it returns you to the C-Kermit prompt. The command may include 
trailing arguments, i/o redirection symbols, and so on, as permitted by the underlying 
operating system. Chapter 2. Synonyms: @, RUN, PUSH, SPAWN. 

# Synonym for ;. 

'.name 

A label, to be used as a target of the GOTO command. Chapter 12. 

<8> [ command ] 

Synonym for!. 

ASG 

Synonym for ASSIGN. 
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Table 1-2 Summary of Backslash Codes 


Code 

Example 

Meaning 

\ 


(at end of command) Line continuation 

\{ 

\{27}3 

Braces are used for grouping 

\% 

\%a 

A user-defined simple variable 

\& 

\&a[ 4 ] 

An array reference 

\$ 

\$(TERM) 

An environment variable 

\b 

\b 

The BREAK signal (OUTPUT command only) 

\d 

\dl23 

A decimal number 

\f 

\feval(2+2) 

A built-in function 

\1 

\1 

The long break signal (output command only) 

\m 

\m(oofa) 

A macro used as a variable 

\o 

\ol23 

An octal number 

\v 

\v(time) 

A built-in variable 

\x 

\xOf 

A hexadecimal number 

\\ 

\\ 

The backslash character itself 


\123 

Decimal digit: a 1- to 3-digit decimal number 


\? 

Anything else: quote the next character 


ASK variable-name text 

Prints the text as a prompt, and stores the line typed by the user in the named variable, 
echoing the user’s keystrokes on the screen. Leading and trailing spaces are trimmed 
from the text prompt unless it is enclosed in { braces >. Chapter 13. 

ASKQ variable-name text 

Exactly like ask, but without echoing. Chapter 13. 

ASSIGN { variable-name, macro-name} text 

Evaluates the text, expanding any variables or function references it might contain, 
and makes the result the value of the named variable or macro. If the text is sur¬ 
rounded by { braces >, they are discarded. Chapter 11. Synonym: ASG. 

BUG 

Displays a brief message describing how to report C-Kermit bugs. 

BYE 

Requests a Kermit server to terminate itself and log out its job. When a C-Kermit 
server receives a BYE command packet, it does everything that the EXIT command 
does, and then logs out its own job and hangs up the connection. Chapter 7. 
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Table 1-3 Summary of Built-in Variables 


Name Description 


\v(argc) 

\v(args) 

\v(cmdfile) 

\v(cmdlevel) 

\v(cmdsource) 

\v(count) 

\v(cpu) 

\v(date) 

\v(day) 

\v(directory) 

Xv(exitstatus) 

\v(filespec) 

\v(fsize) 

\v(home) 

\v(host) 

\v(inchar) 

\v(incount) 

\v(input) 

\v(line) 

\v(local) 

\v(macro) 
\v(ndate) 
\v(nday) 
\v(time) 

\v(platform) 
\v(program) 

\v(return) 

\v(speed) 

\v(status) 

\v(system) 
\v(tfsize) 
\v(time) 
\v(ttyfd) 

\v(version) 


Number of arguments passed to currently active macro 

Number of program command-line arguments 

Name of current command file, if any 

Command level, 0 = top 

PROMPT, FILE, or MACRO 

Current value of set count variable 

CPU type for which C-Kermit was compiled 

Current date in dd mmm yyyy format 

Day of the week: Sun, Mon, Tue, ... , Sat 

Current directory 

Program exit status (return code) 

File specification from most recent file transfer 

Size of file most recently transferred 

Home (login) directory 

The network host name of this computer 

Most recent input character 

Number of characters read by most recent INPUT 

Current INPUT buffer contents 

Current communication device or remote network host name 

1 in local mode, 0 in remote mode 

Name of currently executing macro 

Date in numeric form, for example 19901007 

Day of week in numeric form, 0 (Sun) through 6 (Sat) 

Time of day, seconds since midnight 

Specific machine and/or OS C-Kermit was built for 

Name of this program: C-Kermit 

Most recent return value 

Transmission device speed, or “unknown” 

0 = success, nonzero = failure of previous command 
Generic operating system for which C-Kermit was built 
Total size of most recently transferred file group 
Current time in hh :mm: ss 24-hour clock format 
(UNIX only) File descriptor of communication device 
Numeric C-Kermit version number 
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Table 1-4 Summary of Built-in Functions 


Name Returns Description 


\Fcharacter(n) 

character 

\Fcode(c) 

number 

\Fcontents ( variable) 

text 

\Fdefinition (macro) 

text 

\Fevaluate ( expression) 

number 

\Fexecute (macro args) 

any 

\Ffiles (filespec) 

number 

\Findex(texti ,text2,n) 

number 

\Flength ( text) 

number 

\Fliteral ( text) 

text 

\Flower (text) 

text 

\Flpad ( text,n,c) 

text 

\Fmaximum (n,n) 

number 

\Fminimum( n , n) 

number 

\Fnextfile( ) 

text 

\Frepeat ( text,n ) 

text 

\Freverse ( text) 

text 

\Fright(text,n) 

text 

\Frpad ( text,n,c) 

text 

\Fsubstr (text,nl,n2) 

text 

\Fupper (text) 

text 


Character whose numeric code is given 

Numeric code value of character c 

Value of variable 

Definition of macro 

Value of arithmetic expression 

Return value of macro execution 

Number of files that match filespec 

Position of textl in text2 starting at n 

Length of text 

Literal text, no evaluation 

Letters in text converted to lowercase 

text left-padded to length n with char c 

Larger of the two numbers 

Smaller of the two numbers 

Next filename from \Ff iles () list 

n repetitions of text 

text reversed 

Rightmost n characters of text 
text right-padded to length n with char c 
Substring of text starting at nl, length n2 
Letters in text converted to uppercase 


C Synonym for CONNECT. 

CAT filename 

Displays the file on the screen. Synonym for type. 

CD [ directory ] 

Changes C-Kermit’s current (default) directory. Chapter 2. File specifications that do 
not include full device and directory names will be in or relative to the specified direc¬ 
tory. If the directory is omitted, returns to your home or root directory or, on some 
operating systems, prints the name of the current directory. Synonyms: CWD, 

SET DEFAULT. 

CHECK feature-name 

Checks whether C-Kermit was configured to include the given feature; for example 
check IF-COMMAND for the script programming language. If the feature is available, 
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Table 1-5 Summary of File Transfer Interruption Keys 


Key Description 

X Attempts to cancel the current file (also Ctrl-X, F, Ctrl-F). 

Z Attempts to cancel the rest of the file group (also B, Ctrl-B). 

R Resends the previous packet (also Carriage Return, Ctrl-R). 

A Prints a short status report (also Ctrl-A). 

E Forces a fatal error by sending an Error packet (also Ctrl-E). 

Ctrl-C Returns to the C-Kermit prompt immediately without sending any kind of 
protocol message to the other computer. This is your system’s interrupt 
character, which might be something besides Ctrl-C. 

Ctrl-Z Suspends Kermit in a way that allows it to be continued (only on UNIX 
systems with job control). 

Ctrl-Y Equivalent to Ctrl-C on VMS and OpenVMS. Equivalent to Ctrl-Z on 
certain UNIX systems. 


the command succeeds, otherwise it fails. If the CHECK command is issued from top 
level, a message is printed telling whether the feature is available. If it is issued from 
a command file or macro and the feature is not available, it fails. Type CHECK ? for a 
list of feature-names that can be checked. Use this command for constructing 
configuration-independent command files. 

CLEAR l { INPUT-BUFFER, DEVICE-BUFFER, BOTH } ] 

The CLEAR command erases the contents of the INPUT command buffer, the communi¬ 
cation device input buffer, or both (the default is BOTH). Chapter 13. 

CLOSE file 

Closes the indicated file: DEBUG-LOG, PACKET-LOG, READ-FILE, SESSION-LOG, 
TRANSACTION-LOG, or WRITE-FILE. Chapters 4, 5, 10, 13. 

COMMENT [ text ] 

Does nothing. The text is ignored. 

CONNECT 

(Also -c on the command line) Makes a terminal connection through the serial com¬ 
munication device given in the most recent SET LINE command or to the network host 
in the most recent SET HOST or TELNET command. May be abbreviated as C. Return to 
C-Kermit by typing the escape character, normally Ctrl-\ (Control-Backslash), and 
then the letter C. See also SET ESCAPE, SET TERMINAL. Chapter 4. Escape-character 
commands are listed in Table 1-6. 

CWD 

Change Working Directory. Synonym for CD. 
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Table 1-6 C-Kermit CONNECT-Mode Escapes 
Character Description 

? Help—Prints the available CONNECT-mode escape options. 

l (also @) Enters the local system command processor. Use exit or 
logout to return to C-Kermit connect mode. 

0 (the digit zero) Transmits a NUL (ASCII 0). 

A Sends an Are You There request (TELNET only). 

B Transmits a BREAK signal. 

c Returns to the C-Kermit prompt without breaking the connection 
to the remote computer. 

H Hangs up the phone or network connection, 
i Sends a network Interrupt request. 

L Transmits a Long BREAK signal. 

Q Hangs up and closes the connection, then quits from C-Kermit. 

R (X.25 only) Resets the X.25 connection. 

s Shows the status of the connection: device name, speed, parity, 
and so on. 

z (UNIX only) Suspends Kermit. Use the UNIX fg command to 
continue Kermit’s CONNECT session. 

sp (Space) Nothing, resumes CONNECT mode. 

\ (Backslash) Introduces a backslash code that translates into a 
single character, for example \127 or \xff. 

Ctrl-\ (or whatever your escape character is) Type the escape character 
twice to send one copy of it to the remote computer. 

DCL 

Synonym for DECLARE. 

DECLARE array-name[number ] 

Creates an array with number + 1 elements, 0 through number. Example: declare 
\&x[10 0]. Chapter 11. Synonym: DCL. 

DECREMENT variable-name [ number ] 

Subtracts number from the named variable, if it has a numeric value. If the number is 
omitted, 1 is subtracted. If the variable does not have a numeric value, this command 
fails. Chapter 12. 
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DEFINE { variable-name, macro-name } text 

Makes the text be the value of the named variable or macro. Variable and function 
names in the text are copied literally and not evaluated. If the text is enclosed in curly 
braces, the braces are discarded. Chapter 11. 

DELETE filespec 

Deletes the specified file or files on the local computer. Chapter 2. Synonym: RM. 
DIAL string 

Using the methods implied by the most recent SET MODEM and SET dial commands, 
instructs the modem connected to the device specified in the most recent SET line 
command to dial the telephone number or other character sequence specified by string. 
If a SET dial directory command has been given, the dial command looks up the 
string in the dialing directory file and makes the appropriate substitution. Chapter 3. 

DIRECTORY [ options ] [ filespec ] 

Lists files that match filespec on the local computer by running the underlying operat¬ 
ing system’s file-listing command with the given options, if any. If no filespec given, 
lists all files in the current directory. System-specific command modifiers may be 
given before the filespec in (at least) the UNIX, VMS, Open VMS, and OS/2 versions. 
Chapter 2. Synonym: LS. 

DISABLE { ALL, BYE, CD, DELETE, DIRECTORY, FINISH, GET, HOST, 
SEND, SET, SPACE, TYPE, WHO } 

Instructs C-Kermit, when acting as a server, to refuse or restrict the given command. 
Chapter 7. 

[ DO / macro-name [ argument [ argument [...]]] 

Executes the commands from the definition of the named macro until the end of the 
macro definition is reached, a STOP, exit, end, return, or equivalant command is en¬ 
countered, or a GOTO command is executed for a label that is not in the macro defini¬ 
tion, or a command error occurs and MACRO ERROR is on. The macro arguments (of 
which there may be zero to nine) replace the corresponding argument variables (\%1, 
\%2, .,. \%9) in the macro definition, and the macro name replaces the variable \%0. 
The macro is created with the DEFINE or ASSIGN command. Commands within the 
macro definition are separated by commas, except when enclosed in curly braces. 
Chapter 11. 

ECHO [{] text [}] 

Displays the text on the screen. All backslash codes, variables, and functions are 
evaluated first. Leading and trailing spaces are discarded unless the text is enclosed in 
{ braces >, in which case the braces themselves are discarded. In a macro definition, 
braces must also be used to surround the text if it includes commas. A line terminator 
is supplied automatically at the end of the text. Chapter 2. Also see WRITE SCREEN. 
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ELSE command 

Executes the C-Kermit command if the preceding command was an IF command and 
its condition was not true. Chapter 12. 

ENABLE { ALL, BYE, CD, DELETE, DIRECTORY, FINISH, GET, HOST, SEND, 
SET, SPACE, TYPE, WHO } 

Instructs C-Kermit, when acting as a server, to allow itself to execute the given com¬ 
mand. Chapter 7. 

END [ number [ text ] ] 

Returns immediately from the current command file or macro to the command level 
(command file, macro, interactive command, or host system command line) that in¬ 
voked it. If a number is included, it becomes the return code of the invoking take or 
(implied) DO command: 0 for success, nonzero for failure. If text is included, it is 
printed on the screen. The text may be enclosed in braces to include leading or trailing 
spaces. Chapter 12. Synonym: POP. 

E-PACKET 

Sends a Kermit Error packet on the currently selected communication device, to can¬ 
cel any Kermit protocol operation that might be underway. Chapter 8. 

EXIT [ number ] 

Closes all open files and devices, hangs up any dialed or network connection, restores 
the command terminal to its normal state, executes the macro named ON_EXIT if one is 
defined, and returns to the system. If a number is included, it is C-Kermit’s exit status 
code, otherwise C-Kermit returns a status code whose format depends on the host 
operating system, but which summarizes the overall success of its file transfer opera¬ 
tions. Normal exit codes are 0 (overall success), 1 (program error), 2 (a SEND com¬ 
mand failed), 4 (a receive or GET command failed), 8 (a remote command failed). 

A nonzero return code can be the sum of any combination of these. Chapter 2. 
Synonym: QUIT. 

EXTPROC 

(OS/2 only) When included as the first command in a command file, this allows 
self-running OS/2 C-Kermit scripts, extproc should be followed by the full path¬ 
name of the C-Kermit program, for example extproc C:\CKERMIT\CKERMIT. The 
EXTPROC command is treated by C-Kermit exactly like the COMMENT command, and it 
may be used in non-OS/2 versions (where it has no effect at all). 

FINISH 

(Also -f on the command line) Tells C-Kermit to tell a Kermit server to leave server 
mode and return to wherever server mode was invoked from the Kermit command 
prompt or the host system prompt. Chapter 7. 


Command Summary 331 



FOR variable-name initial final increment { command [, command [,...]]} 

Sets the named variable to the initial value. If the variable’s value is not greater than 
the final value (less than the final value, if the increment is negative), executes the list 
of commands, then adds the increment to the variable, and repeats the process until the 
variable’s value passes the final value. Chapter 12. 

FOT 

Synonym for directory. 

GET [ remote-filespec ] 

(Also -g on the command line) Tells C-Kermit to tell a Kermit server to send, using 
the Kermit file transfer protocol, the specified file or files, whose names are given 
in the remote host’s filename syntax. If the remote-filespec is omitted, C-Kermit 
prompts for it on a second line, and then prompts for a local name to store the file un¬ 
der on a third line. May be abbreviated by the single letter G. To include leading or 
trailing spaces in the remote-filespec , enclose it in braces. Chapter 7. 

GETOK / text ] 

Prints the text, a question whose answer should be Yes or No. The default question is 
“Yes or no?”. The user must answer by typing Yes, No, or OK in upper- or lower¬ 
case, abbreviated or in full. The GETOK command succeeds if the user gives an af¬ 
firmative answer, and fails if the answer is negative. Chapter 13. 

GOTO label-name 

Finds the label in the current macro or command file and begins executing the com¬ 
mands after the label. If the label is not found, returns to the next-higher command 
level and repeats the process all the way up to top level. GOTO commands issued at 
top level, either at the prompt or in a command file that has been redirected to 
C-Kermit’s standard input, have no effect. Chapter 12. 

HANGUP 

On a serial connection, momentarily turns off the Data Terminal Ready (DTR) modem 
signal in an attempt to break a dialed or null-modem RS-232 connection. Correct 
operation depends on cable and modem configuration, and on the underlying operating 
system. Network connections are simply closed. This command has no effect in 
remote mode (without a prior set line or set host command). Chapter 3. 

HELP [ command ] 

Asks C-Kermit to print a brief message describing the given C-Kermit COMMAND. If 
the command is omitted, a brief overview is displayed. Otherwise, you may include 
the name of a command, or, for SET and remote commands only, an optional third 
command word such as HELP SET PARITY or HELP REMOTE DIRECTORY. Chapter 2. 
Synonym: MAN. 
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IF [ NOT / condition command 

If the condition is (not) true, the Kermit command is executed. The IF command may 
be followed immediately (on the next line) by an ELSE command. Chapter 12. The 
conditions are: 

IF < argl arg2 

argl and arg2 both have integer numeric values that are within the precision of the 
underlying computer architecture, and argl is arithmetically less than arg2. The 
results are unpredictable if the values exceed the precision or range of the under¬ 
lying computer architecture. 

IF = argl arg2 

argl is arithmetically equal to arg2. 

IF > argl arg2 

argl is arithmetically greater than arg2. 

IF BACKGROUND 

C-Kermit is running in the background. 

IF COUNT 

This statement subtracts 1 from the COUNT (\v (count)) variable. The condition 
is true if the result is greater than zero. Also see SET COUNT. 

IF DEFINED { variable-name, macro-name } 

The named variable or macro is defined. 

IF EQUAL argl arg2 

The two text string arguments are the same. Alphabetic case is treated according 
to SET CASE. 

IF ERROR 

Synonym for if failure. 

IF EXIST filename 
The named file exists. 

IF FAILURE 

The previous command failed. 

IF FOREGROUND 

C-Kermit is executing in the foreground. 

IF LLT argl arg2 

argl is lexically less than arg2. Alphabetic case is treated according to SET CASE. 
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IF LGT argl arg2 

argl is lexically greater than argl. Alphabetic case treated according to SET case. 
IF NUMERIC text 

The text consists only of decimal digits, 0-9, possibly preceded by a minus sign 
(-). Variables and functions in the text are evaluated before the decision is made. 

IF SUCCESS 

The previous command succeeded. 

INCREMENT variable-name [ number=l ] 

Adds number to the named variable, if it has a numeric value. If number omitted, 1 is 
used. If the variable does not have a numeric value, this command fails. Chapter 12. 

INPUT number [ text ] 

Waits up to number seconds for the given text to arrive from the current communica¬ 
tion device or network connection. Sets SUCCESS if the text arrives within the interval, 
and failure otherwise. Alphabetic case in the text is treated according to SET CASE. 
Leading and trailing blanks are ignored in the text unless it is enclosed in curly braces, 
in which case the braces are discarded. If the text is omitted, arrival of any character 
at all within the timeout interval causes the input command to succeed. Also see set 
INPUT. Chapter 13. 

INTRODUCTION 

Displays a brief introduction to C-Kermit on the screen. 

LOG DEBUG [ filename ] 

(Also -d on the command line) Records internal program debugging information in 
the named file, or if no filename is given, in the file DEBUG.LOG in the current direc¬ 
tory. Also see close. Chapter 6. Synonym: SET DEBUG ON. 

LOG PACKETS [filename] 

Records Kermit’s file transfer packets in the specified file, or in PACKET.LOG if no 
name is given. Also see CLOSE. Chapter 6. 

LOG SESSION [filename] 

Records the characters that appear on the terminal screen during connect in the 
specified file, or in session. log if no filename given. Chapter 4. Also see close, 
set session-log. 

LOG TRANSACTIONS [ filename ] 

Records information about Kermit file transfers and script command execution in the 
named file, transact.LOG by default. Also see CLOSE. Chapter 5. 

LS [ options ] [ filespec ] 

Synonym for DIRECTORY. 
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MAIL filespec address 

Tells C-Kermit to send the specified local file(s) to the other Kermit, which must be 
in RECEIVE or SERVER mode, and to ask the receiving Kermit to deliver the file as 
electronic mail to the given e-mail address. Chapter 7. 

MAN command 
Synonym for help. 

MGET remote-filespec 
Synonym for GET. 

MPAUSE 

Synonym for msleep. 

MPUT filespec — 

Synonym for msend. 

MSEND filespec [filespec [...]] 

(Also -s on the command line) Sends the specified file or files to the other Kermit 
program, which must be in RECEIVE or SERVER mode. Chapter 5. 

MSLEEP [ number= 100 ] 

Does nothing for (at least) the indicated number of milliseconds (thousandths of 
seconds). Chapter 13. Synonym: MPAUSE. 

MV 

Synonym for rename. 

O Synonym for OUTPUT. 

OPEN !READ command 

Starts the specified system command in a way that allows subsequent C-Kermit read 
commands to read its output a line at a time. Chapter 12. 

OPEN ! WRITE command 

Starts the specified system command with its standard input reading from the output 
produced by subsequent C-Kermit write commands. Chapter 12. 

OPEN { APPEND, READ, WRITE } filename 

Opens the specified file for the given type of access. Only one read or !READ file, 
and only one write, iwrite, or append file, may be open at once, read files must 
exist. WRITE files are created, overwriting existing files of the same name. APPEND 
files are appended to, if they exist, otherwise a new file is created. Chapter 12. 

OUTPUT [{] text [}] 

Sends the text out the currently selected communication device. May be abbreviated 
as O. In addition to the normal backslash codes, variables, and functions, the text may 
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include the special codes \B to send a BREAK signal and \L to send a Long BREAK 
signal. Leading and trailing blanks are ignored in the text unless it is enclosed in 
{ braces >, in which case the braces are discarded. Chapter 13. 

PAD CLEAR 

Clears the X.25 virtual circuit. Chapter 3. 

PAD INTERRUPT 

Sends an X.25 interrupt packet. Chapter 3. 

PAD RESET 

Resets the X.25 virtual circuit. Chapter 3. 

PAD STATUS 

Requests an X.25 status report. Chapter 3. 

PAUSE [ number=l ] 

Does nothing for the indicated number of seconds, or until interrupted from the 
keyboard. Fails if interrupted. Chapter 13. Synonym: SLEEP. 

PING [host] 

(TCP/IP only) Sends an ICMP ECHO request to the given host, or if no host is given, 
to the one specified in the most recent SET HOST or TELNET command. System- 
dependent options can be given with C-Kermit’s PING command, according to the 
syntax of your system’s ping command. Chapter 3. 

POP 

Synonym for END. 

PRINT [ options ] [ filename ] 

Prints the given file on a local printer, using the local operating system’s printing com¬ 
mand, with the given options, if any. Chapter 2. 

PUSH [ command ] 

Runs the local host operating system command. If no command is given, enters the lo¬ 
cal host command processor in such a way that exiting or logging out from it returns 
to the C-Kermit prompt. Chapter 2. Synonyms:!, @, RUN, SPAWN. 

PUT 

Synonym for SEND. 

PWD 

Print Working Directory. Shows the current default directory. Chapter 2. Synonym: 

SHOW DEFAULT. 

QUIT 

Synonym for EXIT. 
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READ variable-name 

Reads a line from the current OPEN 'READ subprocess or OPEN read file into the 
named variable. Succeeds if a line is successfully read. Fails if a !READ or READ file 
is not open or is at end of file, or upon subprocess termination, or if a line cannot be 
read for any other reason. Upon failure, closes the read file or terminates the iread 
process. Chapter 12. 

RECEIVE [ filename ] 

File reception using the Kermit file transfer protocol. Waits for one or more files to 
arrive from another Kermit program, which must be given a send command. If a 
filename is given, the first file that arrives is stored under that name instead of the 
name it was sent with. Chapter 5. 

REDIAL 

Dials the phone number given in the most recent DIAL command. Chapter 3. 
REINPUT number text 

Checks whether text that has already been processed by the input command contains 
the given text. Alphabetic case is handled according to SET CASE. The number is re¬ 
quired but ignored. Only works if no more than 256 characters have been input since 
the text first entered the input buffer. Chapter 13. Also see input, set input. 

REMOTE command [ operands ] 

Tells C-Kermit to tell a Keimit server to execute the given command. The results, if 
any, are sent back, using the Kermit file transfer protocol, for display on your screen if 
C-Kermit is in local mode, otherwise they are discarded. Chapter 7. 

REMOTE CD [ remote-directory-name ] 

Requests the Kermit server to change its default directory to the given directory, or if 
none is given, to its default or login remote directory. Synonym: REMOTE CWD. 

REMOTE DELETE remote-filespec 

Requests the Kermit server to delete the specified file or files. 

REMOTE DIRECTORY / options ] [ remote-filespec ] 

Requests the Kermit server to list the specified files, or if none specified, to list all 
files in the current remote directory, using the file-listing command of its underlying 
operating system, with the given options, if any. 

REMOTE HELP 

Requests the Kermit server to list the commands it can respond to. 

REMOTE HOST remote-command 

Requests the Kermit server to ask the remote operating system to execute the given 
command. This works only if the remote-command prints its output on the screen 
(standard output) and does not request any input, and the output is plain text. 
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REMOTE KERMIT remote-kermit-command 

Requests the Kermit server to execute the given Kermit command, which must be 
given in the Kermit server’s own interactive command syntax. 

REMOTE LOGIN userid password [ account ] 

Identifies you to a Kermit server that requires authentication. 

REMOTE LOGOUT 

Removes your login and access rights from a Kermit server to which you have 
previously given a remote login command. 

REMOTE PRINT filespec [ options ] 

Sends the named file or files to the Kermit server and asks it to print them, using any 
specified printer options, which should be given in syntax appropriate for the remote 
computer’s printing command. 

REMOTE SET parameter value 

Requests the Kermit server to set the given parameter to the specified value. 
Parameters include attributes, block-check, file, incomplete, receive, retry, 
SERVER, TRANSFER, WINDOW. See descriptions of corresponding SET commands. 

REMOTE SPACE [ { remote-device-name, remote-directory-name } ] 

Requests the Kermit server to report on available space in the specified area, or if none 
is given, its current disk and/or directory. 

REMOTE TYPE remote-filespec 

Requests the Kermit server to display the contents of the specified file(s) on your 
screen. This is equivalent to having the remote server transfer the file to C-Kermit in 
text mode, except the file is shown on the screen rather than being stored on the disk. 

REMOTE WHO [ remote-user ] 

Requests the Kermit server to send a brief report about the specified user, or if no user 
is specified, about the users who are currently logged in on the server’s system. 

RENAME filename new-name 

Changes the name of the specified local file to new-name. The rules of the server’s 
underlying operating system apply. Chapter 2. 

RETURN [ value ] 

Returns immediately from the current macro to the command level (command file, 
macro, interactive command, or host system command line) that invoked it. If a value 
is given, it is made available to the invoking level in the \v (return) variable. If the 
RETURN command is executed within a macro that was invoked via the \f execute () 
function, the given value is returned as the result of that function. If this command is 
executed outside of a macro, the value is ignored and the command behaves like the 
end command. The return command should not be used in the command list of a 
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FOR, while, or xif command; if it is, the results are unpredictable. Also see stop, 
END, BREAK, CONTINUE. Chapter 12. 

RM filename 

Synonym for delete. 

RUN [ command ] 

Runs the local host operating system command. The command may including trailing 
operands. If no command is given, enters the local host command processor in such a 
way that exiting or logging out from it returns to the C-Kermit prompt. Chapter 2. 
Synonyms: !, @, PUSH, SPAWN. 

SCRIPT text 

Executes the line of text as a series of expect and send strings over the currently 
selected communication device or network connection. See Chapter 13 , page 307 . 

SEND filespec [ alternate-name ] 

(Also -s on the command line) Sends the specified file or files, using the Kermit file 
transfer protocol, to another Kermit program, which must be given a receive or 
SERVER command. If filespec does not contain wildcards, an alternate-name can be 
given to send it with. May be abbreviated as s. Chapter 5. Synonym: PUT. 

SERVER 

(Also -x on the command line) Tells C-Kermit to become a Kermit server, and accept 
further commands only in the form of Kermit packets containing send, msend, GET, 
MAIL, REMOTE, FINISH, and BYE commands. In an emergency, you can return to the 
C-Kermit prompt by typing two Ctrl-C' s in a row. Chapter 7 . 

SET ATTRIBUTES { OFF, ON } 

Turns file attribute packet processing off or on. When attributes are OFF, C-Kermit 
does not send Attribute packets and does not indicate its ability to process them to the 
other Kermit. The attribute mechanism is ON by default. Chapter 8. 

SET ATTRIBUTES ALL { OFF, ON } 

Disables or enables all of the file attributes supported by C-Kermit without disabling 
the file attribute mechanism itself. All attributes are ON by default. 

SET ATTRIBUTES CHARACTER-SET { OFF, ON } 

Turns processing of the file character-set attribute off or on. Turning it off inhibits 
automatic character set notification, but still allows translation that is explicitly re¬ 
quested via SET { FILE, TRANSFER } CHARACTER-SET. Chapter 8. 

SET ATTRIBUTES DATE { OFF, ON } 

Controls processing of the file creation date attribute. When receiving files, OFF 
prevents incoming files from being stored with their original creation dates (the cur¬ 
rent date and time is used instead) and prevents SET FILE COLLISION UPDATE from 
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rejecting incoming files based on date. When sending files, OFF prevents C-Kermit 
from telling the receiving Kermit the file’s creation date and time. Chapter 8. 

SET ATTRIBUTES DISPOSITION { OFF, ON } 

Turns processing of the file distribution attribute off or on. If it is OFF, mail and 
REMOTE print commands cannot be executed, nor will C-Kermit honor incoming 
mail or remote print requests. Chapter 8. 

SET ATTRIBUTES LENGTH { OFF, ON } 

Turns processing of the file length attribute off or on. off prevents files from being 
rejected when the receiving Kermit thinks they are too big to fit in the available disk 
space. Chapter 8. 

SET ATTRIBUTES SYSTEM-ID { OFF, ON } 

Turns notification of the file system ID attribute off or on. Chapter 8. 

SET ATTRIBUTES TYPE { OFF, ON } 

Turns processing of the file type (text or binary) attribute off or on. OFF prevents the 
file receiver from automatically switching between text and binary mode based on the 
file type attribute supplied by the file sender. Chapter 8. 

SET BACKGROUND { OFF, ON } 

Forces C-Kermit into foreground (OFF) or background (ON) mode. In background 
mode, there are no prompts or information messages and no file transfer display. Use 
SET background OFF if C-Kermit’s prompt fails to appear. Chapter 8. 

SET BAUD number 

Synonym for SET speed. 

SET BLOCK-CHECK { 1,2, BLANK-FREE-2,3 } 

Establishes the file transfer protocol error checking level. 1 is weakest but most ef¬ 
ficient, 3 is strongest but least efficient. 1 is the default. 2 and BLANK-FREE-2 are 
equivalent, but the latter is encoded to use only non-blank printable characters. See 
pages 128 and 136 in Chapter 6. 

SET BUFFERS number 1 number2 

In versions of C-Kermit that have been configured for dynamic memory allocation, 
this command allocates number 1 bytes of memory for send-packet buffers and 
number2 bytes for receive-packet buffers. Chapter 8. 

SET CARRIER 

Specifies the desired treatment of the carrier signal during local-mode serial (SET line) 
connections. Chapter 3. 

SET CARRIER AUTO 

Requires carrier during CONNECT only. 
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SET CARRIER OFF 

Tells C-Kermit to ignore carrier at all times. 

SET CARRIER ON [number] 

Requires carrier at all times except while dialing. The optional number tells C-Kermit 
how long to wait for carrier to appear when the set line command is given for a 
modem-controlled device. If no number is given, C-Kermit waits forever (or until 
the command is cancelled via Ctrl-C from the keyboard). 

SET CASE { OFF, ON } 

Ignores (OFF) or pays attention to (on) upper- and lowercase in letters when compar¬ 
ing character strings. Pertains to IF, xif, and input commands and works reliably with 
ASCII letters (A-Z) only, not 8-bit international characters. Applies only to the cur¬ 
rent command level and below; if this command is given in a macro or command file, 
the previous CASE setting is restored when the macro or command file exits. Chapters 
12 and 13. Synonym: SET INPUT CASE. 

SET COMMAND BYTESIZE {7,8} 

The bytesize to be used by C-Kermit’s command interpreter and between C-Kermit 
and your terminal during connect. 7 bits by default. Use 8 to allow transmission of 
8-bit characters between C-Kermit and your keyboard and screen. Chapters 2 and 4. 

SET COUNT number 

Initializes a loop execution counter for use with IF COUNT. The number must be 
greater than 0. Chapter 12. 

SET DEBUG { ON, OFF } 

ON is a synonym for LOG DEBUG. OFF is a synonym for CLOSE DEBUG. 

SET DEFAULT directory 
Synonym for CD. 

SET DELAY number 

The number of seconds to wait after a send command is given before sending the first 
packet, in remote mode only. Gives you time to escape back to your local Kermit be¬ 
fore the first packet comes. Chapter 5. 

SET DIAL 

Controls aspects of the dial command. Display these settings with show dial. 

SET DIAL DIAL-COMMAND [ text ] 

Changes the modem’s dialing command to the given text, which must contain %s to be 
replaced by telephone numbers from the DIAL command. The text may contain back¬ 
slash codes to represent control characters and it may be enclosed in braces to preserve 
leading and/or trailing spaces. If the text is omitted, C-Kermit’s built-in modem- 
specific dialing command is used. Chapter 3. 
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SET DIAL DIRECTORY [filename ] 

Designates the named file as a directory in which the DIAL command should look up 
phone numbers. If the filename is omitted, the dialing directory feature is disabled. 
Chapter 3. 

SET DIAL DISPLAY { ON, OFF } 

Shows selected portions of dialing activity on screen. Normally off. Chapter 3. 

SET DIAL HANGUP { OFF, ON } 

Tells C-Kermit whether to hang up the phone on the communication device in 
preparation for dialing, using the hangup method prescribed by set dial 
modem-hangup. Normally ON. Use OFF if you have trouble with ON. Chapter 3. 

SET DIAL INIT-STRING [ text ] 

Substitutes the given text for Kermit’s built-in modem dialer initialization string. 

The text may contain backslash codes to represent control characters and it may be 
enclosed in braces to preserve leading and/or trailing spaces. If no text is given, 
Kermit’s default modem-specific initialization string is restored. Chapter 3. 

SET DIAL KERMIT-SPOOF { OFF, ON } 

Disables or enables the modem’s “Kermit spoof” if it has one (as Telebit modems 
do). Chapter 3. 

SET DIAL MNP-ENABLE { OFF, ON } 

Enables or disables the modem’s MNP features and negotiation, if it has MNP (and if 
Kermit knows how to do this). Normally, Kermit does not alter the modem’s MNP 
settings. A modem’s MNP features might need to be turned off when dialing to a 
non-MNP modem. Chapter 3. 

SET DIAL MODEM-HANGUP { OFF, ON } 

When DIAL HANGUP is ON, this command determines the hangup method. When DIAL 
modem-hangup is OFF (the default), C-Kermit attempts to turn off the DTR signal for 
about half a second. When DIAL MODEM-HANGUP is ON, C-Kermit issues the modem’s 
escape sequence to put it into command mode, then issues the modem’s hangup com¬ 
mand. If that doesn’t work, C-Kermit drops DTR. Chapter 3. 

SET DIAL PREFIX [ text ] 

Inserts the given text at the beginning of any phone number that you dial, for example 
as an access or area code. The text may contain backslash codes to represent control 
characters and it may be enclosed in braces to preserve leading and/or trailing spaces. 
If no text is given, any previously specified prefix is canceled. Chapter 3. 

SET DIAL SPEED-MATCHING { OFF, ON } 

Normally, C-Kermit’s dial command changes the communication line speed automat¬ 
ically if the modem reports connection at a different speed than the one dialed. 
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However, some modems keep the interface speed constant, even when the connection 
speed changes, but still report the connection speed. To use Kermit with such 
modems, set dial speed-matching off. Chapter 3. 

SET DIAL TIMEOUT number 

The number of seconds to wait for a response from the modem when dialing, overrid¬ 
ing Kermit’s built-in timeout calculation. Chapter 3. 

SET DUPLEX { FULL, HALF } 

Determines which side of a serial terminal connection does the echoing of typed 
characters during CONNECT: the remote computer (FULL) or C-Kermit itself (half). 
Echoing on TCP/IP TELNET connections is negotiated automatically. Chapter 4. 
Synonyms: SET LOCAL-ECHO, SET TERMINAL ECHO. 

SET ESCAPE-CHARACTER number 

Changes C-Kermit’s cONNECT-mode escape character to the ASCII control character 
whose ASCII code is specified by number, which must be 0-31 or 127. Chapter 4. 

SET FILE parameter value 

Alters Kermit’s file-related settings. Chapters 5-10. 

SET FILE BYTESIZE { 7,8 } 

Normally 8, meaning that all the bits in each file byte are considered data. If 7, the 8th 
bit of each file byte is considered extraneous and is stripped during file transfer. 

SET FILE CHARACTER-SET name 

Selects the character-set of the file(s) to be sent or received so Kermit can make the 
appropriate translation to or from the transfer character-set. Choices include ASCII, 
BRITISH, CANADIAN-FRENCH, CP437, CP850, CP852, CP866-CYRILLIC, CYRILLIC-ISO, 
DANISH, DEC-KANJI, DEC-MULTINATIONAL, DG-INTERNATIONAL, DUTCH, FINNISH, 
FRENCH, GERMAN, HUNGARIAN, ITALIAN, JAPANESE-EUC, JIS7-KANJI, KOI8-CYRILLIC, 
LATIN 1, LATIN2, MACINTOSH-LATIN, NEXT-MULTINATIONAL, NORWEGIAN, 
PORTUGUESE, SHIFT-JIS-KANJI, SHORT-KOI, SPANISH, SWEDISH, and SWISS. Chapter 9. 

SET FILE COLLISION option 

Tells what C-Kermit should do if a file arrives that has the same name as an existing 
file. Chapter 5. 

SET FILE COLLISION APPEND 

Appends the incoming file to the end of the existing file. (In VMS and Open VMS, a 
new version of the file is created.) 

SET FILE COLLISION BACKUP 

Renames the old file to a new, unique name and stores the incoming file under the 
name it arrived with. This is the default file collision action. (In VMS and 
Open VMS, a new version of the file is created.) 
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SET FILE COLLISION DISCARD 

Refuses and/or discards the incoming file and preserves the existing file. 

SET FILE COLLISION OVERWRITE 

Overwrites (replaces) the existing file (in VMS a new version is created). 

SET FILE COLLISION RENAME 

Gives the incoming file a unique name (in VMS and Open VMS a new version is 
created), preserving the existing file with its original name. 

SET FILE COLLISION UPDATE 

Accepts the incoming file only if its creation date, as reported in the accompanying 
file attribute packet (if any) is later than that of the existing file. 

SET FILE DISPLAY { CRT, FULLSCREEN, NONE, SERIAL } 

Selects the style of file transfer screen display for local-mode file transfers. The 
default style is serial, off is accepted as a synonym for none and ON is a synonym 
for serial. Chapter 5. 

SET FILE INCOMPLETE { DISCARD, KEEP } 

Tells C-Kermit what to do if receipt of a file terminates with an error or is interrupted 
intentionally. C-Kermit’s normal action is DISCARD: delete the partially received file. 
Chapter 5. 

SET FILE LABEL parameter { OFF, ON } 

(VMS and Open VMS only) Tells C-Kermit which items are to be handled in 
labeled-file transfer, for use with SET FILE TYPE LABELED. Parameters are: ACL, 
BACKUP-DATE, name, owner, and path. Appendix IV. 

SET FILE NAMES { CONVERTED, LITERAL } 

Tells C-Kermit whether to convert file names to “normal form” (all uppercase, no 
strange characters, no device or directory specifications) during file transfer or to use 
them literally, converted is the default. Chapter 5. 

SET FILE RECORD-LENGTH number 

(VMS and Open VMS only) Specifies the record length, in bytes, for incoming binary 
or image files. 512 is the default. Appendix IV. 

SET FILE TYPE BINARY 

Tells C-Kermit to perform no conversions on file data during file transfer. When 
receiving files, this setting can be overridden by the file type in an incoming Attribute 
packet. Chapter 5, Appendix IV. 

SET FILE TYPE BINARY [ { FIXED, UNDEFINED } ] 

(VMS and Open VMS only) Specifies that no conversions be done on incoming files. 
set file type binary is ignored when sending files. An optional record format for 
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incoming files, FIXED or undefined, can be specified after the word BINARY. The 
default record format for creating binary files is FIXED. Can be overridden by the file 
type in an incoming Attribute packet. Has no effect when sending files. Appendix IV. 

SET FILE TYPE IMAGE 

(VMS and Open VMS only) Tells C-Kermit to perform no conversions on file data 
during file transfer and to ignore VMS record attributes. When receiving files, this 
setting overrides the file type in incoming Attribute packets. Appendix IV. 

SET FILE TYPE LABELED 

(VMS and Open VMS only) Tells C-Kermit that RMS and other VMS-specific infor¬ 
mation is (to be) included with the file data. This data can be stored (archived) by 
non-VMS systems, or interpreted by VMS systems to allow reconstruction of complex 
formatted VMS files. The data itself is processed like image. Appendix IV. 

SET FILE TYPE TEXT 

Tells C-Kermit to perform record format and character-set conversions on file data 
during file transfer to make the file useful as text on the receiving computer. When 
receiving, this setting can be overridden on a per-file basis by the file type attribute in 
the incoming Attribute packet. Chapter 5. 

SET FILE TYPE TEXT 

(VMS and Open VMS only) This command is operational only when receiving files, 
but it can be superseded on a per-file basis by the file type attribute in the incoming 
Attribute packet. When sending files, VMS C-Kermit determines automatically 
whether they are text or binary (but this behavior can be overridden by using file types 
of IMAGE or LABELED). Appendix IV. 

SET FLOW-CONTROL { DTR/CD, KEEP, NONE, RTS/CTS, XON/XOFF } 

Tells C-Kermit what kind of flow control to use during file transfer. Xon/Xoff 
(software flow control) is the default, but it is only usable on full duplex connections. 
Use none for half duplex or other connections that do not support Xon/Xoff flow con¬ 
trol. RTS/CTS (hardware flow control) is useful with high-speed modems or other lo¬ 
cally attached high-speed devices, keep means to use whatever flow-control method 
the device was configured with when C-Kermit first opened it. Type SET FLOW ? to 
see which options are available in your version of C-Kermit. Chapters 3, 6. 

SET HANDSHAKE { BELL, CR, ESC, LF, NONE, XOFF, XON, CODE number } 
Tells C-Kermit which character to use for line turnaround during file transfer, meaning 
that C-Kermit will wait for the given character after receiving a packet before it sends 
its next packet. If you specify none, Kermit does not wait for any special character 
after the packet. If you specify CODE, you may enter the numeric ASCII value of the 
handshake character to be used, which must be between 1 and 31, or else 127. Nor¬ 
mally used only in half duplex connections. Chapter 6. 
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SET HOST [ host [ service ] ] 

Tells C-Kermit to use the current network protocol (TCP/IP by default) to establish a 
connection with the host whose name or network number is given. If a service is 
given, use it instead of the default service. Host and service names and numbers 
depend on the type of network. If the connection is established, the command suc¬ 
ceeds. If it cannot be established, an error message is printed and the command fails. 
If no name or number is given, the current connection (if any) is closed. Chapter 3. 

SET INCOMPLETE { DISCARD, KEEP } 

Synonym for set file incomplete. Chapter 5. 

SET INPUT option value 

Controls for the INPUT command. Use SHOW SCRIPTS to display. Chapter 13. 

SET INPUT CASE { IGNORE, OBSERVE } 

Synonym for set CASE { OFF, ON }. 

SET INPUT ECHO { OFF, ON } 

Tells C-Kermit whether to echo text on your screen that is read by the input com¬ 
mand. Normally ON, meaning the text is displayed. Chapter 13. 

SET INPUT SILENCE seconds 

The number of seconds before the INPUT command times out before any characters at 
all arrive from the communication device, if seconds is less than the INPUT timeout in¬ 
terval. Chapter 13. 

SET INPUT TIMEOUT-ACTION { PROCEED, QUIT } 

Tells C-Kermit whether to proceed to the next command in a command file or macro 
definition if an input command fails (times out). The default action is proceed. SET 
input TIMEOUT quit takes precedence over SET MACRO ERROR ON and SET TAKE ER¬ 
ROR ON, but SET macro error on and SET take ERROR ON have precedence over SET 
input timeout PROCEED. Applies only to the current command level and below; if 
this command is given in a macro or command file, the previous input timeout set¬ 
ting is restored when the macro or command file exits. Chapter 13. 

SET KEY number [ text ] 

Assigns the text to the key whose key-press code is number. The key-press code can 
be obtained using show key. The text can be a single character or backslash code, or 
any string of characters. Key mappings accomplished by SET key are effective during 
connect mode. Chapters 4,9; Appendix V. 

SET LANGUAGE name 

Enables language-specific transliterations during text file transfer when either file or 
transfer character-set is ASCII. Type SHOW LANGUAGE for a list of available lan¬ 
guages. Chapter 9. 
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SET LINE [ device-name ] 

Opens a serial communication device for local-mode connections. If the device name 
is omitted, any currently open device is closed and Kermit returns to its default com¬ 
munication device (normally the job’s controlling terminal). Chapter 3. 

SET LOCAL-ECHO { OFF, ON } 

Synonym for set duplex, set terminal echo. 

SET MACRO ECHO { OFF, ON } 

Tells C-Kermit whether to echo commands as it reads and executes them from a 
macro definition. Normally OFF, meaning macro definitions are not echoed during ex¬ 
ecution. Chapter 11. 

SET MACRO ERROR { OFF, ON } 

Tells C-Kermit whether to terminate execution of the current macro automatically if 
it encounters a syntax or execution error. Normally off, meaning errors do not ter¬ 
minate the execution of a macro. Chapter 11. 

SET MODEM name 

Tells C-Kermit the kind of autodial modem you will be using, if any, in local-mode 
communication, none (the default) means there is no autodial modem. If you are 
using a modem, this command must be given before the SET LINE command, so 
C-Kermit can activate the proper modem controls when opening the device. Type a 
question mark or see Table 3-2 on page 53 for a list of supported modems. Chapter 3. 

SET NETWORK name 

Tells C-Kermit the type of network to be used when establishing SET HOST connec¬ 
tions, such as TCP/IP or X.25. Type SHOW NETWORK to see which network types are 
supported by your copy of C-Kermit. If you get an error message, there is no network 
support at all. Chapter 3. 

SET PAD option value 

X.25 PAD settings. Chapter 3. 

SET PAD BREAK-ACTION n 

(X.25 only) X.3 Parameter 7. What C-Kermit’s simulated PAD should do if it 
receives a BREAK signal from your keyboard. 0 = nothing, 1 = send Interrupt packet, 
2 = reset, 4 = send Indication of Break PAD message, 8 = escape to PAD, 16 = discard 
output. Default = 21 (= 16 + 4 + 1). 

SET PAD BREAK-CHARACTER n 

(X.25 only) Default 0. 

SET PAD CHARACTER-DELETE n 

(X.25 only) X.3 Parameter 16. 0-127 = ASCII value of the character to be used for 
erasing a character. Default = 8 (Ctrl-H = Backspace). 
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SET PAD CR-PADDING n 

(X.25 only) X.3 Parameter 9, Padding After Carriage Return (CR). 0-255. Number 
of padding characters PAD should send to DTE after sending a CR. Default = 0. 

SET PAD DISCARD-OUTPUT { 0,1 } 

(X.25 only) X.3 Parameter 8. 0 = normal data delivery (default), 1 = discard output. 
SET PAD ECHO { 0 , 1 } 

(X.25 only) X.3 Parameter 2. 0 = PAD will not echo, 1 = PAD will echo. Default = 1. 
SET PAD EDITING { 0 , 1 } 

(X.25 only) X.3 Parameter 15. 0 = No editing, 1 = editing allowed. Default = 1. 

SET PAD ESCAPE f0,lj 

(X.25 only) X.3 Parameter 1.0 = Escape to PAD not possible, 1 = use Ctrl-P. 

SET PAD FORWARD n 

(X.25 only) X.3 Parameter 3, Data Forwarding Characters. 0 = none, 1 = any alpha¬ 
numeric, 2 = carriage return, others. Default = 2. 

SET PAD LF-INSERT n 

(X.25 only) X.3 Parameter 13, Linefeed (LF) insertion after carriage return (CR). 0 = 
no LF insertion, 1 = PAD inserts LF after each CR sent to DTE, 2 = PAD inserts LF 
after each CR received from DTE, 4 = PAD echoes LF as CRLF. Default = 0. 

SET PAD LF-PADDING n 

(X.25 only) X.3 Parameter 14. 0-255 padding characters to be sent by PAD after 
linefeed. Default = 0. 

SET PAD LINE-DELETE n 

(X.25 only) X.3 Parameter 17. 0-127 = ASCII value of the character to be used for 
erasing a line. Default = 21 (Ctrl-U). 

SET PAD LINE-DISPLAY n 

(X.25 only) X.3 Parameter 18. 0-127 = ASCII value of the character to redisplay an 
edited line. Default =18 (Ctrl-R). 

SET PAD LINE-FOLD n 

(X.25 only) X.3 Parameter 10, Line Folding. 0 = none, 1-255 = number of graphic 
characters per line after which to insert folding characters. Default = 0. 

SET PAD PAD-FLOW-CONTROL { 0 , 1 } 

(X.25 only) X.3 Parameter 5. 0 = No flow control by PAD, 1 = PAD may send 
Xon/Xoff flow control to user. Default = 0. 

SET PAD SERVICE-SIGNALS { 0,1 } 

(X.25 only) X.3 parameter 6, PAD Service and Command Signals. 0 = PAD service 
signals are not sent to DTE, 1 = PAD service signals sent. Default = 1. 
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SET PAD TIMEOUT n 

(X.25 only) X.3 Parameter 4, Data forwarding timeout, 0-255 (twentieths of a 
second). Default = 0 (no data forwarding on timeout). 

SET PAD USER-FLOW-CONTROL { 0,1 } 

(X.25 only) X.3 Parameter 12. 0 = no flow control by user, 1 = user device may send 
Xon/Xoff flow control to PAD. Default = 0. 

SET PARITY { EVEN, MARK, NONE, ODD, SPACE } 

Selects the type of parity to be used on the communication device during terminal con¬ 
nection, script program execution, and file transfer. NONE allows transmission of 8-bit 
data. Any of the others restricts communication to 7-bit data and forces C-Kermit to 
use shifting techniques for 8-bit data during file transfer. Also see SET COMMAND 
BYTESIZE and SET terminal bytesize. Chapters 4,6,8, 9. 

SET PORT 

Synonym for SET LINE. 

SET PROMPT [ text ] 

Changes C-Kermit’s interactive command prompt to text. Leading and trailing blanks 
are ignored in the text unless it is enclosed in curly braces, in which case the braces are 
discarded. If the text is omitted, C-Kermit’s default prompt is restored. Variables in 
the text are evaluated every time the prompt is issued so, for example, your prompt 
string can contain variables like \v (dir) or \v (time) to have Kermit always dis¬ 
play its current directory or the current time. Chapter 2. 

SET QUIET { OFF, ON } 

Controls the display of C-Kermit’s informational (but not error) messages, set quiet 
OFF (the default) enables them, set quiet on suppresses them. 

SET RECEIVE END-OF-PACKET number 

Specifies the numeric ASCII value of the character to be used by the other Kermit to 
terminate the packets it sends to C-Kermit, normally Carriage Return (ASCII 13). The 
number must be the code for an ASCII control character, 0-31 or 127. Chapter 6. 

SET RECEIVE PACKET-LENGTH number 

Specifies the maximum length for packets to be sent to C-Kermit by the other Kermit, 
up to 9024, depending on C-Kermit’s configuration. Chapters 6, 8. 

SET RECEIVE PAD-CHARACTER number 

Specifies the numeric ASCII value of the character to be sent to C-Kermit by the other 
Kermit before the beginning of each packet. Chapter 6. 

SET RECEIVE PADDING number 

Specifies the number of pad characters to be sent to C-Kermit by the other Kermit 
(normally 0). Chapter 6. 
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SET RECEIVE START-OF-PACKET number 

Tells C-Kermit the numeric ASCII value of the character that the other Kermit will 
use to indicate the start of a packet. The number can be the code for any ASCII 
character, but a control character, 0-31 or 127, should be used whenever possible. 

The normal start-OF-packet character is Control-A (= 1). Chapter 6. 

SET RECEIVE TIMEOUT number 

Tells C-Kermit the amount of time the other Kermit should wait for a packet before 
timing out and taking corrective action. Chapter 6. 

SET RETRY number 

Tells C-Kermit how many times any particular packet may be retransmitted (or 
NAK’d) before the file transfer is declared a failure. Chapter 6. 

SET SCRIPT ECHO { OFF, ON } 

Tells whether SCRIPT commands should echo their progress on the screen. Normally 
ON. Chapter 13. 

SET SEND END-OF-PACKET number 

Specifies the numeric ASCII value of the character to be used by C-Kermit to ter¬ 
minate the packets it sends to the other Kermit, normally Carriage Return (ASCII 13). 
Must be a control character. Chapter 6. 

SET SEND PACKET-LENGTH number 

Specifies the maximum length packet C-Kermit may send to the other Kermit, even if 
the other Kermit requests longer ones. This command will not make C-Kermit send 
packets longer than the other Kermit requests. Chapters 6, 8. 

SET SEND PAD-CHARACTER number 

Specifies the numeric ASCII value of the character to be sent by C-Kermit to the other 
Kermit before the beginning of each packet, no matter what pad-character the other 
Kermit asks for. Chapter 6. 

SET SEND PADDING number 

The number of padding characters C-Kermit is to send to the other Kermit (normally 
0), overriding the number of pad-characters the other Kermit requests. Chapter 6. 

SET SEND START-OF-PACKET number 

Tells C-Kermit the numeric character code value of the character that it should use to 
mark the beginning of packets it sends. Can be any ASCII character. Normally 
Control-A (ASCII 1), and should normally be in the control range. Chapter 6. 

SET SEND TIMEOUT number 

Tells C-Kermit the amount of time to wait for a packet from the other Kermit before 
timing out and resending a packet (or sending a NAK), even if the other Kermit asks 
for a different timeout value. Chapter 6. 
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SET SERVER DISPLAY { OFF, ON } 

When C-Kermit is running as a server in local mode, it normally does not produce a 
file transfer display. Use SET server display ON to enable the display. Chapter 7. 

SET SERVER TIMEOUT number 

Tells the C-Kermit server the number of seconds to wait for a command packet from 
the other Kermit before timing out and sending a NAK packet. The normal value is 0, 
meaning not to time out at all during server command wait. Use a nonzero value only 
if the client Kermit program is not capable of timeouts and automatic retransmission. 
Chapter 7. 

SET SESSION-LOG { BINARY, TEXT } 

(UNIX only) How the session log is recorded, text, which is the default, means not 
to record certain characters (such as carriage returns, NUL, and DEL) that are incon¬ 
sistent with UNIX text file format, binary means to record all arriving characters. 
Character-set translation, if elected, is done in both cases. Chapters 4,10. 

SET SPEED number 

The speed (in bits per second) to use on a serial communication device selected by SET 
line. Common values include 1200, 2400, 9600, and 19200. Chapter 3. 

SET SUSPEND { OFF, ON } 

(UNIX only) Tells C-Kermit whether it is allowed to be suspended by keyboard signal 
(normally Ctrl-Z), or by its own SUSPEND or Z command. SUSPEND is ON by default in 
most UNIX implementations. Set this to OFF if suspending Kermit doesn’t work right 
on your computer. Appendix III. 

SET TAKE ECHO { OFF, ON } 

Tells C-Kermit whether to display commands from command files on your screen as it 
executes them. Normally OFF, meaning the commands are not displayed. Chapter 11. 

SET TAKE ERROR { OFF, ON } 

Tells C-Kermit whether to terminate a command file automatically if it encounters a 
syntax or execution error. Normally OFF, meaning the command file is not terminated. 
Applies to current command level and below. Chapter 11. 

SET TELNET ECHO { LOCAL, REMOTE } 

Controls the initial echoing state when making TCP/IP SET HOST or TELNET connec¬ 
tions. After the connection is made, the echoing state can be changed by telnet 
protocol negotiations. The default is local. Chapter 3. 

SET TELNET NEWLINE-MODE { ON, OFF } 

When ON, which is the default, C-Kermit sends carriage return (CR) characters from 
your keyboard to the remote TELNET server as CR-linefeed (CRLF) combinations, ac¬ 
cording to the TELNET specification [51]. Use OFF to send CR as CR alone, followed 
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by NUL (ASCII 0; the NUL is required by the TELNET specification); this should be 
necessary only when the remote telnet server does not conform to the TELNET 
specification. 

SET TELNET TERMINAL-TYPE text 

The terminal-type string to send if requested by the remote telnet server. By default, 
your local terminal type is sent. Chapter 3. 

SET TERMINAL option value 

Changes settings for terminal connection. Chapter 4. 

SET TERMINAL BYTESIZE {1,8} 

Specifies the byte size to use during CONNECT, INPUT, output, TRANSMIT, and similar 
nonprotocol communication commands between C-Kermit and the remote computer. 
Normally 7, meaning that each byte is stripped of its 8th bit. 8 bits are used only if 
TERMINAL BYTESIZE is 8 and parity is none. Chapters 4,9. 

SET TERMINAL CHARACTER-SET remote-cset [ local-cset ] 

Specifies the character sets used on the local and remote computers, respectively, 
during CONNECT, LOG SESSION, and TRANSMIT, so C-Kermit can translate 
between them. The list of character sets should be the same as that for SET FILE 
CHARACTER-SET, but with the addition of TRANSPARENT for no translation. 
TRANSPARENT is the default. If the local-cset is not specified, C-Kermit’s current 
FILE CHARACTER-SET is used. Chapter 9. 

SET TERMINAL COLOR { HELP, NORMAL, REVERSE, STATUS, 
UNDERLINED } foreground-color background-color 

(OS/2 only) Sets the foreground and background colors for the specified types of text 
during VT102 terminal emulation. Color choices include black, blue, brown, 
cyan, dgray (dark gray), GREEN, LBLUE (light blue), LCYAN (light cyan), lgreen 
(light green), lred (light red), MAGENTA, RED, white, and YELLOW. Appendix V. 

SET TERMINAL CR-DISPLAY { CRLF, NORMAL } 

Controls the display of carriage return (CR) characters that arrive from the remote sys¬ 
tem. normal (the default) displays CR as itself. CRLF displays CR as CR plus 
linefeed. Chapter 4. 

SET TERMINAL CURSOR { FULL, HALF, UNDERLINE } 

(OS/2 only) Selects the cursor shape for terminal emulation. Appendix V. 

SET TERMINAL ECHO { LOCAL, REMOTE } 

Tells C-Kermit whether it should echo keyboard characters locally during connect, 
terminal ECHO is remote by default, meaning C-Kermit expects the remote device 
to echo. Synonyms: SET DUPLEX, SET LOCAL-ECHO. Chapter 4. 
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SET TERMINAL LOCKING-SHIFT { OFF, ON } 

Tells C-Kermit whether to use shift-in/shift-out protocol during CONNECT and 
TRANSMIT for 8-bit transparency over 7-bit connections. Chapters 4,9. 

SET TERMINAL NEWLINE-MODE { OFF, ON } 

Normally when you press the Return or Enter key during connect mode, C-Kermit 
sends a carriage return (CR) character, ASCII 13. SET terminal newline-mode on 
tells C-Kermit to send CR and linefeed (LF, ASCII 10) instead. Chapter 4. 

SET TRANSFER CHARACTER-SET { ASCII, CYRILLIC-ISO, JAPANESE-EUC, 
LATIN1, LATIN2, TRANSPARENT } 

Specifies the character set to be used by C-Kermit when transferring text files. When 
sending files, C-Kermit translates from the current file character-set to the selected 
transfer character-set. When receiving files, C-Kermit translates from the specified 
transfer character-set to the current file character-set or, if the sending Kermit has in¬ 
cluded a character-set attribute in a file’s Attribute packet and if attribute 
CHARACTER-SET is ON, C-Kermit uses the transfer character-set specified in the 
Attribute packet. Chapter 9. Synonym: SET XFER CHARACTER-SET. 

SET TRANSFER LOCKING-SHIFT { OFF, ON, FORCED } 

Tells C-Kermit whether to use locking-shift protocol during file transfers when 
PARITY is not NONE. Normally ON. Chapters 8 and 9. Synonym: SET XFER 
LOCKING-SHIFT. 

SET TRANSMIT parameter value 

Modifies the default behavior of the TRANSMIT command. You can display these set¬ 
tings with SHOW transmit. Chapter 10. Synonym: SET XMIT. 

SET TRANSMIT ECHO { OFF, ON } 

Tells C-Kermit whether to echo file characters on your screen during the TRANSMIT 
command. Normally ON. Chapter 10. 

SET TRANSMIT EOF [ text ] 

Tells C-Kermit the character or characters to send after it transmits the last line of 
the file or when you type Ctrl-C to interrupt a transmission. Normally, no characters 
are sent. Chapter 10. 

SET TRANSMIT FILL number 

Tells C-Kermit the numeric ASCII code of the character to be used to fill blank lines 
during execution of the transmit command. Normally, no fill character is trans¬ 
mitted. Chapter 10. 

SET TRANSMIT LINEFEED { OFF, ON } 

Normally, C-Kermit strips linefeeds from TRANSMlTted text files, set transmit 
linefeed on tells C-Kermit to leave them in. Chapter 10. 
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SET TRANSMIT LOCKING-SHIFT { OFF, ON } 

Tells C-Kermit whether to use locking shifts (Shift-In/Shift-Out) to transmit 8-bit 
characters on a 7-bit connection; that is, when parity is not none. Normally OFF. 
Effective only when file type is text. Chapter 10. 

SET TRANSMIT PAUSE number 

Tells C-Kermit how many milliseconds (thousandths of seconds) to pause after trans¬ 
mitting each line of text. Effective only when file type is TEXT. Chapter 10. 

SET TRANSMIT PROMPT number 

Tells C-Kermit the numeric ASCII code of the character to wait for after 
TRANSMlTting each line of a file. Normally C-Kermit waits for the host to echo a 
linefeed (ASCII 10) after the carriage return that is sent at the end of each line. A 
value of zero tells C-Kermit not to wait at all, and to transmit all the characters of the 
file without pausing. Effective only when file type is TEXT. Chapter 10. 

SET UNKNOWN-CHAR-SET { DISCARD, KEEP } 

Whether to keep or discard an arriving file whose Attribute packet announces a trans¬ 
fer character-set unknown to C-Kermit. The default is DISCARD. Chapter 9. 

SET WILDCARD-EXPANSION { KERMIT, SHELL } 

(UNIX only) Tells whether wildcards in filenames (e.g., in the SEND command) should 
be expanded by Kermit itself (the default) or by your login shell. Appendix III. 

SET WINDOW-SIZE number 

Tells C-Kermit the maximum window size to be used in file transfers. This is the 
number of packets (1 through 31) that C-Kermit can send before acknowledgements 
are required, or the number of packets it can receive that are later than a missing 
packet. Chapter 8. 

SET X.25 CALL-USER-DATA { OFF, ON text} 

(X.25 only) ON lets you specify up to 12 characters of call user data required by the 
X.25 host you are calling. Normally OFF. Chapter 3. 

SET X.25 CLOSED-USER-GROUP { OFF, ON n } 

(X.25 only) off = no closed user group, ON n specifies the user group number, 0 to 99. 
off by default. Chapter 3. 

SET X.25 REVERSE-CHARGE { OFF, ON } 

(X.25 only) OFF = caller pays, ON = callee pays. Default is OFF. Chapter 3. 

SET XFER 

Synonym for SET transfer. 

SET XMIT 

Synonym for SET TRANSMIT. 
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SHOW 

Lists C-Kermit’s most important settings. 

SHOW ARGUMENTS 

Shows the arguments to the currently active macro, if any. Chapter 11. 

SHOW ARRAYS 

Lists the names and dimensions of all currently declared arrays. Chapter 12. 

SHOW ATTRIBUTES 

Lists C-Kermit’s file attributes and tells whether each is ON or off. Chapter 8. 

SHOW CHARACTER-SETS 

Lists the current file, transfer, and terminal character-sets. Chapter 9. 

SHOW COMMUNICATIONS 

Lists the current communication device or network host and the other communication- 
related items: speed, parity, duplex, dial parameters, modem signals, etc. Chapter 3. 

SHOW COUNT 

Displays the current value of the COUNT (\v (count)) variable. 

SHOW DEFAULT 

Shows the current directory. Synonym for PWD. 

SHOW DIAL 

Displays the current SET dial and related settings. Chapter 3. 

SHOW ESCAPE 

Shows current CONNECT-mode escape character. Chapter 4. 

SHOW FEATURES 

Lists the features that C-Kermit was configured with and the features that were 
omitted, along with compilation options. Chapter 1. 

SHOW FILE 

Lists current values of file-related parameters. Chapters 5-10. 

SHOW FUNCTIONS 

Lists the names of C-Kermit’s built-in functions. Chapter 12. 

SHOW GLOBALS 

Lists the names and values of currently defined global variables, \%a through \%z. 
Chapter 11. 

SHOW KEY 

C-Kermit asks you to press a key. In response, C-Kermit tells you the key’s key-press 
code (for use with SET KEY) and its current definition, if any. Chapter 4. 
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SHOW LABELED-FILE-INFO 

(VMS and Open VMS only) Displays current SET FILE LABEL settings. Appendix IV. 
SHOW LANGUAGES 

Lists the languages supported by the C-Kermit SET LANGUAGE command, along with 
the current language, file character-set, and transfer character-set. Chapter 9. 

SHOW MACROS [ name ] 

Lists the definitions of all macros whose names begin with name. If name is omitted, 
all defined macros are listed. To get a list of the names of defined macros without 
their definitions, type DO ?. Chapter 11. 

SHOW MODEM-SIGNALS 

Shows the current modem type and, if the underlying operating system supports it, 
lists the state of modem signals on the currently selected communication device, if it 
is a serial device. Chapter 3. 

SHOW NETWORK 

Shows network protocols, current settings, and active connections. Chapter 3. 

SHOW PAD 

(X.25 only) Lists X.25 PAD-related parameters. Chapter 3. 

SHOW PROTOCOL 

Lists the current Kermit file-transfer protocol-related settings. Chapters 5,6, 8. 

SHOW SCRIPTS 

Lists the current SET TAKE, SET MACRO, SET INPUT, and SET SCRIPT values. 

Chapters 11-13. 

SHOW SERVER 

Lists server-related settings, including which server commands are enabled and dis¬ 
abled. Chapter 7. 

SHOW STATUS 

Tells whether the previous command succeeded or failed. Chapter 12. 

SHOW TERMINAL 

Lists SET TERMINAL settings. Chapters 4, 9, 10. 

SHOW TRANSMIT 

Lists the current SET TRANSMIT settings. Chapter 10. Synonym: SHOW XMIT. 
SHOW VARIABLES 

Lists the names and values of C-Kermit’s built-in variables. Chapter 11. 

SHOW VERSIONS 

Lists the version numbers and dates of each of the C-Kermit program modules. 
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SLEEP [ n ] 

Sleeps for n seconds. Synonym for PAUSE. See PAUSE. 

SPACE [ device ] 

Displays operating-system-specific information about disk usage in the specified or 
current device and directory on the computer where C-Kermit is running. Chapter 2. 

SPAWN [ command ] 

Synonym for run, push. 

STATISTICS 

Displays statistics about the most recent file transfer. Chapter 8. 

STOP [ number [ message ] ] 

Returns from the current command file or macro to the topmost command level: the 
C-Kermit prompt if the program is in interactive mode, or to the host operating system 
if C-Kermit was invoked with command-line action arguments. If the optional 
number is included, it becomes the status of the top-level take or DO command, 0 for 
success, nonzero for failure. If a message is given, it is printed on the screen. The text 
may be enclosed in braces to include leading or trailing spaces. Chapter 12. 

SUSPEND 

(UNIX only) Halts C-Kermit and returns to the host operating system in such a way 
that C-Kermit can be continued later, either in the foreground or in the background. 
Appendix III. Synonym: Z. 

TAKE filename 

Executes commands from the named file until the end of the file is reached, an END, 
STOP, return, exit, or quit command is encountered, a command error occurs and 
take error is ON, or a GOTO command is encountered whose target label is outside 
the file. Chapters 2, 11. 

TELNET [ host [ service ] ] 

Establishes a TCP/IP telnet connection to the given host, which can be an IP host 
name or dotted numeric address. The service can be a TCP service name or number. 
The default service is 23, telnet. If the host and service are both omitted, resumes 
the currently active TCP/IP connection, if any. Chapter 3. 

TRANSLATE filel csl cs2 [ file2 ] 

Translates the file filel from the character set csl into the character set cs2 and puts 
the result in fde2 or, if file2 is not specified, on the screen. The available character 
sets are the same as for SET FILE CHARACTER-SET. Chapter 9. Synonym: XLATE. 

TRANSMIT filename 

Sends the characters from the file out the currently selected communication device. 
Use this command for sending files to computers that don’t have Kermit programs. 
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No error checking is done. If the file type is TEXT, character-set translation is done 
and transmission is line-oriented. If file type is binary, characters are sent in a con¬ 
stant stream with no modification. Chapter 10. Synonym: XMIT. 

TYPE filename 

Displays the named local file on the screen. Chapter 2. 

VERSION 

Displays C-Kermit’s main version number. Chapter 2. 

WAIT [ number =1 [ { CD, CTS, DSR }...]] 

Waits up to the given number of seconds for all of the specified modem signals to ap¬ 
pear on the currently selected (SET line) communication device. Completion status is 
SUCCESS if all of the given modem signals were sensed before the timeout expired, 
otherwise FAILURE. Can be interrupted from the keyboard. Chapter 13. 

WHILE condition { command, [ command [,...]]} 

While the condition is true, executes the commands in the command list. The con¬ 
ditions are the same as for the IF command. Chapter 12. 

WHO [ { user, user@host, @host ] 

Lists users logged in to the local computer, or lists information about the specified 
user on the local computer or on the specified remote host computer. ( @host notation 
available on UNIX only.) Chapter 2. 

WRITE { DEBUG-LOG, ERROR, FILE, PACKET-LOG, SESSION-LOG, 
SCREEN, TRANSACTION-LOG } [{] text[}] 

Writes the text to the indicated file. All backslash codes, variables, and functions are 
evaluated first. Carriage return and linefeed are not supplied automatically at the end 
of the text, as they are by the ECHO command. Leading and trailing spaces are dis¬ 
carded unless the text is surrounded by { braces >, in which case the enclosing braces 
themselves are discarded. Chapter 12. 

XIF condition { command [, command...] } [ ELSE { command [, command...] } ] 
If the condition is true, executes the command or commands enclosed in the first set of 
curly braces. If an ELSE-part is provided, and the condition is not true, executes the 
commands inside the second set of curly braces. The conditions are the same as for 
the regular IF command. Chapter 12. 

XLATE 

Synonym for translate. 

XMIT 

Synonym for TRANSMIT. 

Z Synonym for suspend. 
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Appendix II 

A Condensed Guide to Serial 
Data Communications 


Communication between two computers requires not only a physical connection, but also 
an agreement about how the computers will use it. When you establish the connection 
yourself, for example by dialing up or installing your own cable, you need to understand 
the elements that must agree. Otherwise a working connection is an unlikely stroke of 
good fortune. 

Character Format and Parity 

A byte, or character, is generally made up of 8 bits. Textual data is represented by a 
specific code, such as ASCII or ISO Latin-1. ASCII and other 7-bit codes leave one of the 
8 bits unused, so in many applications this spare bit is dedicated to a rudimentary kind of 
error detection called parity. The extra bit, or parity bit, is set to 0 or 1 to make the over¬ 
all number of 1 bits even (or odd). For reasons lost in antiquity, or perhaps simply for 
completeness, there also exist “mark parity” (in which the parity bit is always 1), and 
“space parity” (in which the parity bit is always 0). Thus there are five possibilities for 
parity: even, odd, mark, space, and none. Parity is commonly used with 7-bit character 
codes. Figure II-1 on the next page shows a 7-bit character with even parity and an 8-bit 
character with no parity. 

The devices on both ends of a data connection should agree on their parity settings, other¬ 
wise data can be misinterpreted. For example, 11000101 is Latin-1 A-ring on an 8-bit 
connection, uppercase E on a 7-bit connection with even or mark parity, and it’s an illegal 
bit combination on a 7-bit connection with odd or space parity (see Figure II-l). 
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ASCII Capital Letter A Latin-1 Capital A with Ring (A) 



t 

Even Parity Bit No Parity 

Figure II-l Character Formats 


Serial Asynchronous Transmission 

Characters are transmitted over short distances using digital signals: small discrete vol¬ 
tages representing the binary digits (bits) 0 and 1, such as +12V for 0 and -12V for 1, 
transmitted through copper wires. The electrical characteristics and distance limitations 
are spelled out in a venerable industry standard, EIA RS-232 [28] (or CCITT V.24 [8], its 
international counterpart) followed by practically every computer manufacturer. In the 
terminology of RS-232 and V.24, a computer or terminal is data terminal equipment , DTE 
for short. The word terminal designates a device that is at the end of a connection, which 
is often, indeed, a terminal; that is, a device with a keyboard, a screen, and a communica¬ 
tions interface. 

The bits within a character are transmitted in series, one after the other, in a specified 
order [2] through a wire connecting the two devices. This method of transmission, 
referred to as serial transmission, is preferred for all but very short distances over the 
more expensive parallel method, which requires one wire for each of the 8 bits in a 
character. 

When a terminal is connected to a computer, the computer cannot predict when the person 
at the terminal will strike a key; the terminal and the computer are not synchronized. 
During serial transmission in this environment, characters are delimited using a “start bit” 
(0) and a “stop bit” (1) so the receiver knows where each character begins and ends [3], 
as shown in Figure II-2. The stop bit lasts until the next character comes. This mode of 
serial communication is said to be asynchronous. 


ASCII Capital Letter A 



t 


Even Parity Bit 

Start Bit --, 

y Direction of Transmission \ 


1 . . . 
t 

Stop Bit 


Figure II-2 Asynchronous Character Transmission Format 
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Transmission Speed 

Even in asynchronous communication, however, two DTEs are not entirely unsyn¬ 
chronized. The transmitters and receivers of each computer must be running at the same 
speed for the receiving computer to recognize each bit correctly, based on how long a bit 
“lasts.” The transmission speed is expressed in bits per second (bps), sometimes called 
baud. Speeds commonly used in asynchronous serial data communication are 75, 110, 
150, 300, 600, 1200, 2400, 4800, 9600, 14400, 19200, 38400, and 57600 bps. 44 If the 
speeds of the two devices do not agree, successful communication can not occur. 

Ten bits are required to transmit a character: the 8 bits of the character itself plus the start 
and stop bits. Therefore, 10 bits per second (bps) is the same as one character per second 
(cps) if characters are transmitted without gaps (long stop bits) between them. 

It is possible, and common in some parts of the world, for the receiver and transmitter to 
run at different speeds. For example, a terminal sends characters at 75 bps and the com¬ 
puter receives them at 75 bps, but the computer sends and the terminal receives at 1200 
bps. This is called split speed operation. 

“Plex” 

An asynchronous serial connection between two DTEs can be characterized by how the 
data flows. If data may go in one direction only, the connection is said to be simplex, or 
one-way. If data can go in both directions, the connection is duplex, or two-way. 45 

A duplex connection can be made using a single data wire or channel if the data goes in 
one direction at a time; this mode of transmission is called half duplex or two-way 
alternate. A special signal, called a handshake, is required to turn the direction around. 
Single-wire connections are rare, but half duplex communication is still common in main¬ 
frame computing environments. On a half duplex connection between a terminal and a 
computer, the terminal must echo each character you type. This is called local echoing. 

Today, most asynchronous serial communication takes place over two data wires, one for 
each direction. Data can go in both directions at once; this is called full duplex or two-way 
simultaneous. A full-duplex connection lets you type characters at the same time received 
characters are being displayed on your screen, and it allows a computer to control the ap¬ 
pearance of your screen by echoing characters selectively. 


44 RS-232 is not designed to work at speeds beyond about 20000 bps, but many modem communication 
boards offer higher speeds. Speeds in excess of 19200 require very short direct connections, perhaps 
using special shielded and/or low capacitance cables. 

45 Notice the dual terminology. The first term is the one used in American data communications 
literature, and the second term is the one used by international standards. 
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Flow Control 

Whenever Computer A is sending data to Computer B, there is always the chance that 
Computer A’s data will arrive faster than Computer B can process it. On a full duplex 
connection, where characters can travel in both directions at once, Computer B can tell 
Computer A to stop sending data even while the data is arriving. This gives Computer B a 
chance to “catch up”; when it has finished processing the characters that have accumu¬ 
lated, it tells Computer A to resume sending. 

This process is called flow control. It is most commonly accomplished using the control 
characters Ctrl-S (ASCII DC3) to stop the flow of data, and Ctrl-Q (ASCII DC1) to re¬ 
sume it. In the context of flow control, these characters are called XON and XOFF, 
respectively. Flow control accomplished by mixing special characters with the data itself 
is called “in-band” or “software” flow control. Xon/Xoff flow control works when the 
computers have a full-duplex connection, both computers observe this convention, and the 
connection between them is clean enough not to damage these special characters during 
transmission. 

Hardware flow control is accomplished using separate wires, most commonly the RS-232 
RTS and CTS circuits, and is therefore “out of band.” It is much more reliable and 
responsive than software flow control, but can generally be used only over short distances, 
such as between a computer and the modem it is directly connected to. 

Modems 


The maximum distance allowed by RS-232 is 50 feet, about 15 meters. To connect two 
DTEs over longer distances requires special data communications equipment, or DCEs. 
These are usually powered devices that boost the data’s signal strength and modulate its 
form to allow it to travel greater distances. A modem 46 is a DCE that translates between 
the digital representation of computer data and the type of analog signaling that is used by 
traditional voice telephones. Modems are commonly used to connect distant computers to 
each other over the switched telephone network by placing telephone calls. Modems let 
any two computers in the world communicate with each other when a phone call can be 
placed between them and the modulation techniques of the two modems are compatible. 

In a dialup modem connection, the modem actually replaces the telephone. It does what 
the telephone does, but instead of converting between human voice and analog electronic 
signals on the phone wire, it converts between the computer’s digital signals and the 
analog phone signals. 


46 The word modem is derived from the words modulator and demodulator. 
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Each computer must have its own modem, as shown in Figure II-3. The computer placing 
the call tells the modem to dial the number; it picks up the phone, listens for dialtone, and 
dials the given number by simulating the clicks or beeps of the telephone it is mimicking. 
When the other modem answers the call, the originating modem sends a constant tone at a 
certain (originating) frequency. The answering modem recognizes this tone and replies 
with its own tone at a different (answering) frequency. When the two modems recognize 
each other’s tones, the connection is complete and ready to use. These tones are called the 
carrier signal, and remain active throughout the connection. Transmitted data is im¬ 
pressed upon the carrier signals to alter their frequency, amplitude, or phase. 

Modem Signals 

Computers communicating through modems must be able to monitor and control them, 
just as people can monitor and control a phone call. For example, if you hear a click and a 
dialtone in the middle of a telephone conversation, you have good cause to suspect you’ve 
been disconnected and you can hang up your phone. This means you don’t have to wait 
forever for the other party to finish a sentence. This sounds silly, but it’s the kind of thing 
a computer might do if it couldn’t tell when a connection is broken. 

Modems handle such problems quite nicely, using special circuits defined by RS-232 and 
V.24 for signaling between the modem and the computer. The 10 circuits used in 
asynchronous serial communication are listed in Table II-l on the next page. The Circuit 
column shows the RS-232 name for the circuit; the V.24 column shows the CCITT V.24 
circuit number. The DB-25 column shows the pin assignments for a standard RS-232 
25-pin connector; the DB-9 column shows the pin assignments for the 9-pin connector 
used on the IBM PC/AT and PS/2. 
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Table II-l RS-232-C Modem Signals and Pins 


Circuit 

V.24 

Name 

Direction 

DB25 

DB9 

Comments 

FG 


Frame Ground 


1 

- 

Electrical safety 

TD 

103 

Transmitted Data 

ToDCE 

2 

3 

Data from computer 

RD 

104 

Received Data 

To DTE 

3 

2 

Data to computer 

RTS 

105 

Request To Send 

ToDCE 

4 

7 

Hardware Flow Control 

CTS 

106 

Clear To Send 

To DTE 

5 

8 

Hardware Flow Control 

DSR 

107 

Data Set Ready 

To DTE 

6 

6 

DCE on and in data mode 

SG 

102 

Signal Ground 


7 

5 

Voltage measurement reference 

CD 

109 

Carrier Detect 

To DTE 

8 

1 

Modems are communicating 

DTR 

108 

Data Terminal Ready 

ToDCE 

20 

4 

DTE on and in data mode 

RI 

125 

Ring Indicator 

To DTE 

22 

9 

Phone is ringing 


A modem call from computer A to computer B progresses something like this, as seen 

from the point of view of computer A (the originator of the call): 

1. Computer A checks to see that Modem A’s DSR signal is on. If not, the computer 
concludes that the modem is not connected or not turned on, and the call fails. 

2. Computer A turns on its DTR signal to let the modem know that it wants to begin 
communicating. 

3. Computer A gives Modem A the command to dial a phone number. 

4. Modem A takes the phone “off hook” and listens for dialtone; if there is none, the 
process stops here. Otherwise Modem A dials the number and waits for an answer. 

5. If there is no answer within a prescribed amount of time, Modem A reports failure to 
the computer, and the process stops here. 

6. When the other modem answers. Modem A sends its originate-frequency tone to it and 
waits for an answer-frequency tone. If none appears within a certain time, the process 
fails and stops here. 

7. When the originating modem hears the answering modem’s tone, it turns on its CD 
circuit, so the computer knows it may exchange data with the other computer. 

8. If Computer A turns off its DTR signal at any time during the connection, Modem A 
hangs up the phone. If Modem A stops hearing Modem B’s carrier tone at any time 
during the connection, it turns off its CD signal. 
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The situation on the answering end (B) is similar. Modem B “hears” the phone ring and 
turns on its RI signal. Computer B sees RI come on, prepares itself to communicate, and 
then turns on its DTR signal. Modem B sees DTR and starts sending its carrier tone to the 
other modem. The two modems attempt to settle on a modulation technique (explained on 
page 367) and, if they succeed, both modems turns on their CD signals and communica¬ 
tion between Computers A and B commences. 

Detecting Failures Automatically 

During the connection between computers A and B, at least five different components can 
fail: Computer A, Modem A, Computer B, Modem B, and the dialed connection itself. 
Using only two modem signals, CD and DTR, all components of the connection can detect 
a failure anywhere in the communication path and can shut themselves down gracefully in 
the event of any failure so computer data can be preserved and the telephone connection 
can be hung up: 

• If Computer A dies suddenly, its DTR signal goes off. Modem A notices this and 
stops sending its carrier tone and hangs up the phone. This makes Modem B turn off 
its CD signal, which makes Computer B turn off its DTR signal, which makes Modem 
B hang up its end of the phone connection. The same thing happens in the other direc¬ 
tion if Computer B dies. 

• If Modem A suddenly stops working (because, for example, you tripped over the 
power cord and pulled it out of the receptacle), then Computer A no longer receives 
the CD or DSR signals and knows the connection is broken. Meanwhile, Modem B 
notices the absence of carrier and turns off CD and hangs up its end of the phone con¬ 
nection. The same thing happens if Modem B dies—just exchange A and B in all the 
sentences in this paragraph (except this one). 

• If the connection itself is broken, both modems notice the loss of carrier and both turn 
off CD, so both computers know the connection is broken. Of course, the computers 
also turn off their DTR signals to make the modems hang up the phone, but since the 
connection is broken already, who cares? 

Automatic Dialing 

Most modem modems contain a little computer that accepts commands from the terminal 
or PC in the form of characters and reports the results back, also in character form. Al¬ 
though there is an international standard [9] specifying the repertoire and format of these 
commands and responses, it is not widely followed. In most parts of the world, modem 
dialing languages are defined by the modem makers, and there are many such languages. 
Perhaps the most popular dialing language is the Hayes AT command set, partially listed 
in Table II-2 on the next page. 


Modems 365 



Table II-2 Selected Hayes Smartmodem 2400 Commands 


Command Action 


AT 

AT&C1 

AT&D2 

ATE1 

ATMO 

ATQ0V1 

ATXO 

ATX1 


No action. Modem responds “OK” if it is in command state. 

CD signal tracks carrier (recommended). AT&CO keeps CD on always. 

Modem hangs up and returns to command state if PC turns off DTR 
(recommended). AT&DO makes modem ignore DTR signal from PC. 

Enables echoing of modem commands (recommended). ATEO disables 
echoing. 

Turns off speaker. ATM1 turns on speaker while dialing. 

Selects verbal result codes (OK, CONNECT) rather than numeric. 
Enables OK, CONNECT, RING, and NO CARRIER result codes. 

Enables OK, CONNECT, RING, NO CARRIER, ERROR, CONNECT 
1200, and CONNECT 2400 result codes. 


ATX4 


ATDTnnnnnnn 


ATDP nnnnnnn 
ATDnnnnnnn 


Enables OK, CONNECT, RING, NO CARRIER, ERROR, CONNECT 
1200, NO DIALTONE, BUSY, CONNECT, and CONNECT 2400 result 
codes (factory setting). 

Dials the phone number nnnnnnn (simulate Touch-Tone dialing). The 
phone number may contain digits, spaces, parentheses, and hyphens, which 
are ignored. A comma in the dial string causes the modem to pause 
(normally 2 seconds, specified in register S8). The letter W means wait up 
to 30 seconds (limit specified in register S7) for dial tone. An exclamation 
mark (!) means “hook flash”—hang up the phone for half a second, then 
reconnect. An at-sign (@) means to wait for the phone to stop ringing. 

Dials the phone number, like ATDT, but with pulse (rotary) dialing. 

Dials the phone number using the modem’s default dialing method 
(Touch-Tone or Pulse). 


ATH0 

+++ 


ATO 

ATZ 

ATS0=0 


Hangs up the phone. 

Returns to command state without dropping the connection. This is the 
modem’s escape sequence. It is ignored unless a full second of silence 
precedes and follows it, to prevent consecutive plus signs in your data from 
interfering with communication. 

(Letter O) Returns to online state from command state. 

Initialize: Restores normal configuration. 

Enters answer mode (wait for a call). 


ATS7=n«n Waits up to nnn seconds for carrier. Default depends on modem model. 

ATS8=nnn Duration of comma dial modifier. Default is 2 seconds. 


ATS10=nnn Delay between carrier loss and hangup, lOths of seconds. 
ATS25=n/w DTR change detect time, lOOths of seconds. 
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In Hayes language, commands begin with the two letters AT. The command to dial a 
phone number is ATDT or ATDP (depending on whether Touch-Tone or pulse dialing is 
required) followed by the phone number and then a carriage return (press the Return or 
Enter key). The modem dials the number, waits for a response, and then reports the 
results using either a numeric code or a descriptive English word or phrase like CON¬ 
NECT, CONNECT 1200, CONNECT 2400, BUSY, NO ANSWER, NO DIALTONE, or 
NO CARRIER [32], Some useful Hayes commands are listed in Table II-2; each com¬ 
mand must be terminated by a carriage return. Computer programs are easily written to 
feed commands to an autodial modem and interpret the results. 

According to RS-232 and V.24, there is (or should be) no carrier during the dialing 
process. Carrier appears only after the connection is complete. Therefore, computer 
software like Kermit that controls modems must be prepared to ignore carrier during the 
dialing process, but to pay attention to it after the connection is complete. 

However, some computer systems (such as Data General AOS/VS) do not allow serial 
communication to occur at all in the absence of carrier, so the modem (or the cable con¬ 
necting it to the computer) must be configured to assert CD all the time. This robs the 
computer of the ability to detect a broken connection. Similarly, some computers do not 
turn on their DTR signals properly, so the modem must be configured to ignore DTR. In 
general, a modem should be configured to: 

• Pay attention to DTR from the computer. If DTR goes off, hang up the phone. 

• Turn on Carrier Detect only when the two modems have carrier. 

Modulation, Error Correction, and Compression 

Modems communicate with each other using an ever-expanding variety of modulation 
techniques, such as the ones listed in Table II-3 on the next page. Most modem modems 
support more than one such technique. In order for two modems to communicate, they 
must have at least one modulation technique in common and each must have a way to find 
the common technique. 

When you place a call, the modem begins with a particular modulation technique. The 
technique is chosen according to the interface speed between your computer and the 
modem or according to the modem’s configuration. For example, a V.32 modem might 
try to connect to the remote modem using V.32 if your interface speed is 9600, V.22 bis if 
it is 2400, V.22 if it is 1200, and V.21 or Bell 103 if it is 300. 

Suppose your modem tries to connect using V.32. If the other modem responds with a 
V.32 carrier signal, the modems recognize each other immediately and your modem raises 
its CD signal and tells you the connection is complete. If, however, the other modem does 
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Table II-3 Modem Modulation Techniques 


Designation 

Description 

CCITT V32bis 

14400 bps; full duplex 

CCITT V.32 

9600,4800,2400; full duplex 

CCITT V.29 

9600 bps; for leased lines, but used by MNP Class 6 

CCITT V.26 ter 

2400 bps; full duplex 

CCITT V.26 bis 

2400,1200 bps; half duplex with 75 bps back channel 

CCITT V.22 bis 

2400, full duplex 

CCITT V.22 

1200 bps, full duplex 

Vadic VA3400 

1200 bps, full duplex 

Bell 212A 

1200 bps, half duplex 

CCITT V.23 

600,1200 bps, half duplex with 75 bps back channel 

CCITT V.21 

300 bps, full duplex, incompatible with Bell 103 

Bell 103 

110,150, 300 bps, full duplex 


not support V.32, your modem will execute its fallback procedure. The fallback proce¬ 
dure is what allows modems of differing capabilities to find a common language. In this 
case your modem might fall back to V.22 bis and, if that doesn’t work, to V.22, and so on. 

Modems that implement different fallback strategies might not be able to connect to each 
other automatically, even if they do have a modulation technique in common. In such 
cases, it is your job to configure your modem to change its initial modulation technique, 
its fallback scheme, or both. 

Error Correction 

Error-correcting modems have been available for about ten years. They are designed to 
overcome transmission errors caused by noisy telephone connections. Error correction, 
when it is effective, occurs only on the connection between the two modems, and not on 
the connection between each modem and its computer or terminal. 

Error correction requires a communications protocol, similar to Kermit’s, between the two 
modems. Data sent by each modem is packaged with framing and checksum information; 
the other modem receives these structured messages, checks them for damage, and re¬ 
quests retransmission if necessary or else extracts the original data and passes it along to 
the receiving computer. 

Several techniques are commonly used for error correction. Some of them are listed in 
Table II-4. To achieve an error-free connection, two modems must share at least one error 


368 A Condensed Guide to Serial Data Communications / Appendix II 






Table II-4 Modem Error Correction and Compression Techniques 


Designation Description 


MNP Class 1 
MNP Class 2 
MNP Class 3 
MNP Class 4 
MNP Class 5 
MNP Class 6 
MNP Class 7 
MNP Class 9 
PEP 

CCITT V.42 
CCITT VAlbis 


Error Correction: Asynchronous byte-oriented half duplex ARQ 
Error Correction: Asynchronous byte-oriented full duplex ARQ 
Error Correction: Synchronous bit-oriented full duplex ARQ 
Error Correction: MNP Class 3 plus dynamic packet size 
Data Compression: Used in conjunction with MNP Class 4 
MNP Class 5 plus Universal Link Negotiation and Statistical Duplexing 
Enhanced Data Compression: used in conjunction with MNP Class 4 
MNP Class 7 combined with V.32 modulation 

Telebit Packet Ensemble Protocol, a combination of modulation, error con¬ 
trol, and compression 

Error Correction: Link Access Protocol for Modems (LAPM), the inter¬ 
national standard error correction technique for modems 

Data Compression: The international standard compression technique for 
modems 


correction technique. The error-correction method is settled after carrier has been es¬ 
tablished; that is, after the two modems have found a common modulation technique. 
Now that the modems can communicate with one another, they send messages attempting 
to negotiate an error-correction protocol. 

Suppose, for example, you are dialing with an MNP Class 4 modem. Once carrier is es¬ 
tablished, your modem sends a message to the other modem requesting to use MNP Class 
4 error correction. If the other modem is capable of MNP Class 4 operation, it agrees. If 
it is capable of a lower MNP class of error control, it notifies your modem and your 
modem falls back to the lower level. However, if the other modem does not support any 
level of MNP operation, it passes your modem’s negotiation message through to the 
remote computer or service, which is very likely to result in incorrect speed recognition, a 
failed login, or a hung-up connection. 

Most modem modems can be configured to use or skip error-correction, and to employ 
various fallback schemes in negotiating the error-correction method with the other 
modem. If you have trouble establishing a connection from an error-correcting modem, 
try turning off its error-correction feature, choosing a different error-correction method, or 
altering the modem’s error-correction fallback scheme. 

After you have made a successful error-corrected connection between two modems, your 
troubles are still not over. Suppose, for example, you have told the remote host to display 
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a long file. Suddenly there is a period of severe noise on the telephone connection, caus¬ 
ing many retransmissions between the two modems. The remote modem is so busy 
retransmitting previous data that it is not able to accept new data from the remote com¬ 
puter, yet the remote computer continues to send it. The modem needs a way to tell the 
computer to stop sending data for a while; that is, an effective flow control method. With¬ 
out one, data will be lost. 

Similarly, you need effective flow control between your own computer and modem, other¬ 
wise the modem might deliver data to your computer faster than the computer can handle 
it, or vice versa. 

Data Compression 

Above your modem’s modulation and error-correction techniques, there can be still 
another layer of protocol between the two modems: data compression. As with modula¬ 
tion and error-correction, various compression techniques are available, some of which are 
listed in Table II-4, and the same cautions about negotiation, fallback, and flow control 
hold true. 

How control is absolutely essential when compression is operational. In theory, data can¬ 
not come out of modem B faster than it went in to modem A. In practice, however, it is 
common that the interface speeds of the two modems are different, and therefore the data 
sent to the slower modem by the faster one must be flow-controlled by the slower 
modem’s computer. If you do not have an effective method of flow control—preferably 
RTS/CTS—you should disable your modem’s compression feature. 

A glance at Tables II-3 and II-4 gives you an idea of the many possible combinations of 
modulation, error-correction, and compression techniques offered by modem modems. 
Each modem manufacturer offers a different selection, different default configurations, 
different fallback schemes, and different ways to control all of these. New techniques are 
developed with alarming frequency and hit the marketplace with little delay. When you 
buy a new, full-featured modem, be prepared to spend long hours studying the manual and 
experimenting with its configuration and settings. 

Cables and Connectors 


The cable that connects a computer to a modem—that is, a DTE to a DCE—is called a 
modem cable. It includes at least the circuits listed in Table II-l on page 364, and il¬ 
lustrated in Figure II-4, which also shows the direction of the signal and the connector pin 
numbers for standard 25-pin connectors. In a modem cable, the wires go “straight 
through,” connecting DTR on one side to DTR on the other, CD on one side to CD on the 
other, and so on, for each circuit. The cable terminates in connectors on each end. 
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DTE 

(Computer) 


DCE 

(Modem) 


1 FG - 

2 TD - 

3 RD <- 

4 RTS - 

5 CTS <- 

6 DSR < 

7 SG - 

8 CD 

20 DTR - 
22 Rl < 


- 1 FG 
2 TD 

- 3 RD 

■*- 4 RTS 

- 5 CTS 

- 6 DSR 

- 7 SG 

- 8 CD 

20 DTR 

- 22 Rl 


Figure II-4 Asynchronous Modem Cable Schematic 


Gender 

A connector is either female or male, like the ones shown in Figure II-5 on the next page. 
Male connectors have pins sticking out, female connectors have holes to plug the pins 
into. By convention, DTEs have male connectors, DCEs female. 47 

Number of Pins 

The most common type of connector has 25 pins (or holes), one for each of the 25 RS-232 
circuits; this is called a DB-25 connector. The assignment of connector pins to RS-232 
circuits is specified by the RS-232 standard. 9-pin (DB-9) and 8-pin (Din-8) varieties are 
becoming increasingly common, but vendors don’t follow a particular standard in assign¬ 
ing circuits to pins; each pin is numbered and assigned a circuit arbitrarily. 

Case 

The pins or holes are joined to the wires and housed inside a compact case, as shown in 
the figure, for protection and ease of handling. So, like Latin nouns, data connectors have 
gender, number, and case. 

Null Modems 

It is possible to connect two DTEs (such as two computers, or a terminal and a computer) 
directly to each other without any intervening modems. This is done using a null modem 
cable, 48 in which the wires do not go straight through, but are cross-connected in various 
ways as shown in Figure II-6 on the next page, which also shows the DB-25 pin numbers. 


47 But conventions are made to be broken. When a connector is the wrong gender, an inexpensive adapter 
called a gender changer can be employed. 

48 Small null modem adapters, or modem eliminators, turn a modem cable into a null modem cable. 
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9-Pin Male 


9-Pin Female 



Model A 
“Fakeout” 

(4 wires) 


Model B 

True Null Modem 

(8 wires) 


FG 

TD 

RD 

RTS 

CTS 

DSR 

SG 

CD 

DTR 


1 

2 

3 

4 

5 

6 

7 

8 

20 



) c 
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8 

20 


FG 1 
TD 2 
RD 3 
RTS 4 
CTS 5 
DSR 6 
SG 7 
CD 8 
DTR 20 
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4 

5 

6 

7 

8 

20 



Figure II-6 Asynchronous Null Modem Schematics 


The computers are tricked into believing they are connected to real modems. With the 
“fakeout” model (A), the two computers can transmit data but cannot signal each other in 
any other way. With a true null modem (B), each computer can detect when the other 
computer crashes or otherwise stops communicating. 
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In UNIX, VMS, and Open VMS computer systems, the system administrator may define 
serial communication devices as either modem-controlled or direct lines. On a modem- 
controlled line, the operating system insists upon receiving the CD signal, and possibly 
also DSR and CTS. If carrier drops, the next attempt to read a character from the device 
will result in a “device error,” unless the device is opened in a special mode (such as the 
CLOCAL mode in UNIX). 

On a direct line, modem signals are ignored. A direct line is typically used for a terminal, 
PC, or printer connected directly to a computer serial communication device with a short 
RS-232 null modem cable containing as few as three or four wires (sometimes the frame 
ground wire is omitted, but this is not recommended). 

It is impossible to list specific cabling requirements for every kind of computer that 
C-Kermit runs on. You will probably have to consult the technical documentation for 
your computer. But a few general tips might smooth the way: 

• On PCs and workstations, don’t use an internal modem unless it is fully supported by 
your computer’s operating system. Before buying an internal modem, make sure it 
works with Kermit. 

• For modem connections, use whatever modem cable is supplied or recommended by 
your computer manufacturer. 

• For direct connections between two computers, use the supplied or recommended 
modem cable for each computer and interconnect the two modem cables with a 
modem eliminator. 

• If your connections suffer from electrical interference, shielded cables and connectors 
(which are more expensive) might help. 

Detailed debugging of modem signals and null modem cables can be accomplished with a 
device called an RS-232 breakout box, available in computer supply catalogs. Another 
handy tool is the loopback connector, which can be used to test cable integrity. 


Cables and Connectors 
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Appendix III 


UNIX C-Kermit 


This appendix explains how to configure and use C-Kermit on a computer with the UNIX 
operating system. For an up-to-date list of limitations and restrictions in the UNIX ver¬ 
sion of C-Kermit, also read the files ckcker. bwr and ckuker. bwr. 

UNIX has become a generic term, referring to a large family of operating systems whose 
members include AIX, A/UX, BSD, CTIX, DG/UX, DNIX, DYNIX, DRS/NX, ESIX, 
HP-UX, IRIX, ODT, OSF/1, POSIX, Solaris, SunOS, System V, ULTRIX, UMAX, 
UMIPS, UNICOS, UNOS, XENIX, and many more. Each of these products differs from 
the others in numerous ways and each product goes through numerous releases. An im¬ 
portant goal in the design of C-Kermit has been portability among the many releases of 
the many UNIX products on the market (see page 13 for a list) and easy adaptibility to fu¬ 
ture products and releases; see the files ckcplm.doc and ckccfg.doc for details. 

Installation 


oooo 

Detailed instructions for building and installing UNIX C-Kermit are given in the 
file ckuins. doc in the C-Kermit distribution and in the UNIX C-Kermit 
makefile itself. This section discusses the thorny issues of dialout device access 
that are of interest not only to the C-Kermit installer but all too often to the 
C-Kermit user too. Skip ahead to page 382 if you do not need to use C-Kermit 
for dialing out, or if C-Kermit is already configured correctly for dialing out on 
your UNIX computer. 
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Configuring tty Devices for Dialing Out 

A device appears to the UNIX user as a file, usually in the /dev area. Here are some 
samples from a Sun-4 (Is -1 /dev/*): 


crw-rw-rw- 

i 

root 

13, 

0 

Jun 

26 

11:33 

/dev/mouse 

(A Mouse) 

crw-rw-rw- 

i 

root 

3, 

2 

Aug 

3 

13:44 

/dev/null 

(The null device) 

crw-rw-rw- 

i 

root 

30, 

0 

Aug 

3 

12:38 

/dev/rmtO 

(A magnetic tape) 

crw-rw-rw- 

i 

root 

2, 

0 

Aug 

3 

14:24 

/dev/tty 

(Controlling tty) 

crw-rw-rw- 

i 

root 

44, 

0 

Jun 

26 

12:03 

/dev/ttyhO 

(Specific ttys) 

crw—w—w- 

i 

root 

44, 

1 

Aug 

3 

15:03 

/dev/ttyhl 


crw—w- 

i 

cmg 

44, 

2 

Aug 

8 

15:00 

/dev/ttyh2 


crw—w- 

i 

fdc 

44, 

3 

Jun 

11 

05:09 

/dev/ttyh3 



The tty devices are what we’re interested in. Different UNIX systems have different 
names for them, but they are generally of the form /dev/tty followed by two charac¬ 
ters, such as 00 or h2 (/dev/tty by itself is a special generic device that refers to the 
user’s controlling terminal, or console). Other commonly used forms include /dev/acu, 
/dev/cua, /dev/cub, etc. (cu stands for “calling unit,” acu for “automatic calling 
unit”). Write permission (w) does not allow users to delete the file, but it does allow them 
to write to the associated device. 

A UNIX terminal device is inbound, outbound, or both. An inbound terminal is for people 
to use as the controlling terminal of an interactive UNIX session. Each inbound terminal 
on the computer is being watched by a process called “getty,” which waits for a connec¬ 
tion to appear, and then issues the login prompt. Outbound terminals are not watched by 
getty, and cannot be logged in on. These are used for dialing out to other computers. 
Some UNIX systems allow terminal devices to be bidirectional, meaning they can be used 
both for logging in and for dialing out. 

The system administrator (superuser) configures each terminal device as inbound, out¬ 
bound, or bidirectional. The method varies from system to system. You must consult 
your UNIX system administration manual for the relevant method. Traditionally, tty con¬ 
figuration is done by editing a file called /etc/ttys, which contains entries that look 
like this: 

12console 

02ttya 

12ttyb 

02ttyh0 

12ttyhl 

12ttyh2 

12ttyh3 

This file is read by the init process at system startup time. Two digits precede the tty 
name; you are concerned with the first digit: 0 means the line is outbound (no getty), 1 
means the line is inbound (has getty). 
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Some UNIX systems have a more generalized way of defining terminals to the init 
process. For example, SunOS uses the file /etc/ttytab, which includes information 
about the terminal speed and type as well as whether getty is on or off: 


ttyhO 

"/usr/etc/getty 

std.9600" 

vtlOO 

off 

tty hi 

"/usr/etc/getty 

std.19200" 

vtlOO 

on 

ttyh2 

"/usr/etc/getty 

std.9600" 

vtlOO 

on 

ttyh3 

"/usr/etc/getty 

std.9600" 

vtlOO 

on 


Dialout lines must be configured with getty off, or if your system allows it, as bidirec¬ 
tional lines. 

It is normally not necessary to shut down and restart your UNIX system in order to recon¬ 
figure a terminal device. Rather, you can edit the appropriate tty configuration file and 
then restart the init process, which is always process number 1: 

$ kill -1 1 

This operation, of course, requires superuser (root) privilege. 

Once the tty device is configured to allow dialout, its permissions must also be set to let 
users access it in read and write mode: 

$ Is -1 /dev/ttyh4 

crw—w- 1 root 44, 2 Aug 8 15:00 /dev/ttyh4 

$ chmod qo+rw /dev/ttyh4 
$ Is -1 /dev/ttyh4 

crw-rw-rw- 1 root 44, 2 Aug 8 15:00 /dev/ttyh4 

The chmod command adds read and write (rw) permission to ttyh4 for members of its 
group (g) and all others (o). 

Finally, on certain workstations, it might be necessary to configure the terminal driver for 
dialing out. For example. Sun SPARCstations might come with serial ports that are not 
set up for use with a modem. To configure the serial port for dialout use, follow the direc¬ 
tions in your system installation or system and network manager’s guide. This might in¬ 
volve changing jumpers on your serial port board, reconfiguring the serial device driver, 
or both. 

Ensuring Exclusive Access 

Most operating systems allow serial devices such as terminals and magnetic tapes to be 
opened by only one job at a time. Any attempt to open the same device by another job 
results in an error like “exclusive access denied” or “device assigned by another user.” 

UNIX devices, however, can be shared by all users who have access to them based on 
their permissions. So if user A has a dialout connection over /dev/ttyh4, UNIX does 
not prevent user B from using /dev/ttyh4 at the same time, even though there is no 
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conceivable reason to allow this. The result of multiple users reading from the same serial 
device is that the incoming characters are fanned out to them, as if they were hands of 
poker—nobody sees the whole deck. And of course, if multiple users write to the same 
device, then who- or whatever is on the other end will receive only a confused jumble of 
characters, impossible to sort out. 

Before there was Kermit, there was UUCP, the UNIX-to-UNIX Copy Program [55], 
UUCP was developed at AT&T Bell Laboratories by Mike Lesk in 1976, and publicly dis¬ 
tributed for the first time with Version 7 of UNIX. It soon became the basis of Usenet, a 
loose voluntary confederation of UNIX computers that call each other up at night and ex¬ 
change files, news, and electronic mail. It was not long until someone discovered that 
running two copies of UUCP at the same time on the same dialout line resulted in no use¬ 
ful exchange of data. The solution was, and remains to this day, the UUCP lock file. 

UUCP and every other program on the computer that might be using a dialout line, includ¬ 
ing kermit, cu, tip, umodem, sz, and rz, are expected to observe a special convention: if 
the program wants to use a particular dialout tty device, first it checks to see if a file with a 
certain name exists in a certain directory, and if so the program does not attempt to use the 
tty device. If the file does not exist, the program must create it before starting to use the 
device and must destroy the file when it is finished. This file is called the UUCP lock file; 
its name is based on the tty device name. 

Within a particular UNIX vendor’s software offerings, this convention tends to work— 
uucp, cu, and tip are produced in the vendor’s controlled proprietary environment. Unfor¬ 
tunately, the situation is not so controlled for Kermit, which needs to run on UNIX plat¬ 
forms from many manufacturers: 

• The directory that contains the UUCP lock files is different on different systems: 
/usr/spool/uucp, /usr/spool/locks, /var/spool/locks, many others. 

• The directory that contains the lock file may or may not be publicly readable and/or 
writable. 

• The format of the lock file name can vary from system to system: ttyh4, 
LCK..ttyh4, and so on. 

• Although the lock file name includes the device name, it might be subtly modified; for 
example, in SCO Xenix, the lock file for /dev/ttylA is LCK. .ttyla (lowercase let¬ 
ter a). 

• There might be more than one lock file; certain versions of IBM AIX require two lock 
files, one named (for example) LCK. . ttyO, and the other simply ttyO (in fact, the 
second is a link to the first). 
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• The lock file itself may or may not be publicly readable and/or writable. 

• The creation date and time of the lock file may or may not be significant. 

• The contents of the lock file may or may not be significant. Some versions of UUCP 
require that the lock file contain the process ID (pid) of the process that created it. 

• The format of the contents of the lock file can vary from system to system: the pid 
may be a binary integer (or other data type, such as short or long), or an integer in 
ASCII string format. 

• Even on the same computer, lock file conventions can change from one UNIX release 
to the next, for example from SunOS 4.0 to SunOS 4.1 on Sun computers, or from 
AT&T System V R3 to R4. 

• Recent UNIX standards like POSIX don’t even try to address this issue. 

Therefore, you must determine what lock file conventions are in use on your system and 
build Kermit to correspond to them; this is not always an easy task, because this informa¬ 
tion tends to be missing from vendor documentation. Each C-Kermit “make” option 
takes a best guess, but for Kermit to fit in properly with uucp, cu, and tip, you should 
make certain that this guess is correct. Here is one way to check: 

1. Get a directory listing (Is -lg) from each of the possible lock file directories: 
/usr/spool/uucp, /usr/spool/locks, /var/spool/locks, /etc/locks (this 
is not necessarily a complete list). 

2. Run one of your vendor-supplied UUCP-family communication programs, such as cu, 
giving the name of your dialout device. Example: 

$ cu -1 /dev/ttya 

This procedure assumes you are using cu. 

3. Escape from cu back to your local shell by typing carriage return, then tilde (-), then 
exclamation mark (l). 

4. At the shell prompt, repeat step 1. 

5. Exit from the inferior shell, exit from cu (carriage return, tilde, period). 

6. Compare the directory listings to see which files, in what format, with what permis¬ 
sions, in which directories were created by cu. 

In recent years, UNIX vendors have been converting to a new and somewhat more stan¬ 
dardized version of UUCP called “Honey DanBer” (after its authors, Peter Honeyman, 
David A. Nowitz, and Brian E. Redman, who rewrote the original UUCP in 1983). If this 
trend continues, much of the confusion can be eliminated. 


Installation 379 



Installing Kermit without Privileges 

If you are the sole user of a UNIX workstation, you don’t have to worry about other users 
abusing their privileges or interfering with your work, so you need not be concerned with 
the material in this section. 

If you are the manager of a multiuser UNIX system where all the users trust each other, 
and you trust them, you can make access to your tty devices and lock file directory un¬ 
restricted. For example, if your lock file directory is /usr/spool/uucp and your 
dialout device is ttyh4, give the following commands from superuser command level: 

su% chmod 777 /usr/spool/uucp 
su% chmod 666 /dev/ttyh4 

The risk here is a free-for-all in the lock file directory; users can store any file there at all, 
and delete any file as well. They can even remove each others’ lock files, despite the fact 
that the lock files are created with 444 (read-only) permission. Deletion is possible be¬ 
cause the directory has write permission, which is required for people to create their lock 
files in the first place. And there is also some risk of one user interfering with another’s 
use of the tty device. 

To make your tty devices available only to a selected group of users, put those users in the 
uucp group (or whatever other group is used by uucp, tip, and cu). The method for doing 
this varies from system to system, but generally involves editing the /etc /group file to 
add these users to the uucp entry in that file. You don’t have to make the Kermit program 
setuid or setgid, or give it any particular owner or group, but you do have to ensure that 
the uucp lock directory and the appropriate tty devices are members of the uucp group, 
and have the appropriate permissions in the group field: 

su% chqrp uucp /usr/spool/uucp 
su% chmod 770 /usr/spool/uucp 
su% chqrp uucp /dev/ttyh4 
su% chmod 660 /dev/ttyh4 

Installing Kermit with Privileges 

On multiuser UNIX systems where access to the uucp directory or to tty devices is a 
security issue, it is possible to restrict access to the lock file directory and the dialout tty 
devices, then give the Kermit program privileges to override these restrictions, and some 
or all users the ability to run the privileged Kermit. This prevents users from circumvent¬ 
ing the lock file conventions built into Kermit (and uucp, cu, and tip), and therefore from 
accessing a tty device that somebody else is already using. It also prevents them from 
creating, modifying, or destroying files in the lock file directory. 

Despite the attractions of this setup, there are also serious risks. Any program that runs in 
privileged mode poses a tremendous security threat to your system, much greater than the 
possible inconveniences of open lock directories and tty devices. Although every effort 
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has been made to ensure C-Kermit contains no loopholes, the slightest bug or oversight on 
the part of the authors or anyone who has modified or customized the source code—not to 
speak of the damage that could be done intentionally—could open doors for intruders. 
This warning is not particular to Kermit: it applies to all UNIX programs. 

If you really want to make Kermit a privileged program, first make sure you have built it 
correctly for your system. There are several important compile-time options that must be 
considered, and that vary from system to system. The most important of these is whether 
your version of UNIX supports the “saved original setuid” feature. If it does not, then 
Kermit will not work right as a privileged program—it should not pose a security risk, but 
it won’t be able to access protected files or tty devices either. For details, read the files 
ckuins.doc (the installation instructions), ckuker.bwr (the “beware” file), and 
ckcplm.doc (the program logic manual). 

To install Kermit as a privileged program, make the owner of the Kermit program the 
same as the owner of the lock file directory and the tty device, and set the setuid bit in the 
Kermit program’s permissions, so that while running Kermit, the user has the privileges of 
useruucp. For example: 

su% chown uucp kermit (kermit's owner is uucp) 

su% chmod u-srwx,q=rx,o=rx kermit (Turn setuid bit on) 

su% chown uucp /usr/spool/uucp (Lock directory owned by uucp) 

su% chmod 700 /usr/spool/uucp (Can only be accessed by owner) 

su% chown uucp /dev/ttyh4 (Dialout device owned by uucp) 

su% chmod 600 /dev/ttyh4 (Can only be accessed by owner) 

The UNIX version of C-Kermit includes special code to turn off these privileges as soon 
as it starts up, and to turn them on only when it is manipulating lock files or accessing the 
tty device, so that files are accessed and subprocesses are run with the user’s own identity 
and access rights, but this code cannot be guaranteed to work correctly for every release of 
every variation of UNIX. 

Caveat Installator! 

For the lock file mechanism to achieve its desired purpose—prevention of access to the 
same tty device by more than one process at a time —all programs on a given computer 
that open, read or write, and close tty devices (kermit, uucp, cu, tip, sz, rz, and so on) must 
use the same lock file conventions. 

Be alert to changes in new releases of your UNIX operating system. The installation pro¬ 
cedure might change the permissions on your lock file directories and tty devices. What’s 
more, it is quite common these days for new UNIX releases to change their lock file con¬ 
ventions; the new versions of uucp, tip, and cu will follow the new conventions, but Ker¬ 
mit and other communication programs that are not distributed by your UNIX vendor will 
still be using the old ones until you reconfigure (or reprogram!) them. 


Installation 381 



Using UNIX C-Kermit _ 

UNIX operating systems are available for computers ranging from small desktop systems 
to large mainframes and supercomputers. To accommodate smaller computers that have 
restrictions on physical memory, address space, disk space, or compiler or linker capacity, 
C-Kermit can be built in reduced configurations. This is required primarily for UNIX ver¬ 
sions running on DEC PDP-1 Is and on 8088, 8086, 80186, or 80286 PCs, and is generally 
not necessary elsewhere. The three major C-Kermit configurations are: 

1. Fully configured, but perhaps without Kanji character set and/or fullscreen display. In 
most cases, these features can be added by simple changes to the build procedure (see 
the files ckccf g.doc and ckuins. doc for instructions). 

2. Minimum interactive. The C-Kermit prompt appears and a minimum set of com¬ 
mands is available for terminal connection and file transfer. There is no character-set 
translation, script programming language, or built-in help text. 

3. Command-line only. This configuration has no prompt, no interactive dialog, and no 
initialization file. It is controlled exclusively with the command-line options listed in 
Chapter 14, with the exception of -y, -Y, -C, -S, and any others that imply the 
availability of interactive commands. 

See the file ckccf g. doc for detailed information about C-Kermit configuration options. 

If you have an interactive version of C-Kermit, you can use the SHOW features com¬ 
mand to find out exactly which features are included and excluded. If the SHOW 
features command itself is missing, you can use the check command, which is included 
in all interactive configurations, for example: 

C-Kermit >check kanji 
Not available 
C-Kermit> 

Preparing UNIX for C-Kermit 

To make effective use of C-Kermit in the UNIX environment and, for that matter, to use 
UNIX itself to best advantage, you should ensure that your UNIX session is speaking the 
same language as the terminal or emulator that you are using to access it. 

Establishing Your Terminal Type 

Before starting C-Kermit, you should tell the UNIX system what kind of terminal you 
have so C-Kermit’s fullscreen file transfer display (if available) will work correctly. 

To identify your terminal to UNIX, try one of the methods from Table III-1, which uses 
the DEC VT300-series terminal as an example. The actual method used depends not only 
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Table III-l Setting Your Terminal Type in UNIX 


Shell 

Command 


Bourne shell (sh) 

TERM=vt300 ; 

export TERM 

Kom shell (ksh) 

TERM=vt300 ; 

export TERM 

C-shell (csh) 

setenv TERM 

vt300 


on your shell, but on the site- or vendor-dependent peculiarities of your UNIX system. 
For example, some UNIX systems use a program called term or tset; others might 
prompt you for a terminal type when you log in. 

To test whether your terminal type is set correctly, try a command that changes the ap¬ 
pearance of your screen, such as “clear” (Berkeley UNIX) or “tput clear” (AT&T UNIX) 
to erase the terminal screen, or start a screen-oriented editor like VI or GNU EMACS. If 
your screen does not respond as expected, try another terminal type. In most cases, lower¬ 
case letters are required in the terminal name. 

If you use a speaking or Braille device to read the screen to you, tell UNIX that you have a 
simple hardcopy terminal, such as a Teletype Model 33. Most UNIX systems support this 
under the name “tty” or “tty33.” Also use this terminal type if you are logging in from a 
real hardcopy terminal, such as a TDD (Telecommunication Device for the Deaf). 

Checking and Setting Your Communication Speed 

When you use C-Kermit to transfer files in remote mode, it calibrates its packet timeouts 
based on what UNIX thinks is the communication speed of your login terminal. If your 
terminal or PC is connected directly or via modem to a serial communication port on your 
UNIX computer, UNIX knows your communication speed. But if you have dialed in at 
(say) 2400 bps through a terminal server, UNIX probably thinks your speed is 38400 bps, 
and file transfers might not work well, or at all. 

To be sure UNIX knows your true serial communication speed, give the commands tty 
and stty; you’ll see something like this (ignore the incomprehensible parts): 

$ tty (Show my terminal's device name) 

/dev/ttyh3 

$ stty (Show its characteristics) 

speed 9600 baud; evenp hupcl clocal 
$ 

If you have entered the UNIX system through any kind of network connection—a ter¬ 
minal server or a TELNET or rlogin session—you are not logged in on a “real terminal” 
(tty), but rather to a “pseudoterminal” (pty), so UNIX does not know the actual com¬ 
munication speed of your terminal: 
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$ tty 

/dev/ttyp5 (Device name has "p" in it) 

$ stty 

speed 38400 baud; evenp (Speed is probably wrong) 

§ 

If there is a serial device anywhere along the communication path between your desktop 
and the UNIX system, tell UNIX the true speed of the device as soon as you log in, before 
starting C-Kermit, EMACS, or any other software that might be speed-sensitive: 

$ stty 2400 
$ stty 

speed 2400 baud; evenp 
$ 

UNIX Control Characters 

The UNIX operating system and many UNIX applications support the use of control 
characters (and sometimes also printable characters) for editing or interrupting commands. 
The repertoire of functions available, and the characters that are assigned to them, can be 
discovered by using the stty command: 

% stty all 

(or stty -a, or stty everything). 

In response, you should see a report that includes the following information (specific ap¬ 
pearance may vary): 

erase kill werase rprnt flush lnext susp intr quit stop eof 

A ? A U A W A R A 0 A V A Z/ A Y A C A \ A S/ A Q A D 

These are the “significant characters” in your UNIX login session. Their meanings are 
listed in Table III-2. Control characters are shown in circumflex notation; A u means 
Control-U, A \ means Control-Backslash, and A ? means Delete. (For a complete listing of 
circumflex notation, see Table VIII-2 on page 462.) 

You can change the interrupt character or any of the others in the list with the stty com¬ 
mand. Normally, the method is to give the name of the terminal function you want to 
change, followed by the character you want to change it to, written in circumflex notation. 
For example, to change your interrupt character to Ctrl-B, enter: 

% stty intr A B 

(that’s circumflex followed by the letter B, not a real Ctrl-B). To disable a function al¬ 
together, use (depending on your UNIX version) undef or A - (circumflex hyphen): 

% stty quit undef or stty quit 

For details about the use of the stty command on your system, type man stty. 
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Table HI-2 UNIX Terminal Control Characters 


Notation Meaning 


eof 

The 

erase 

The 

flush 

The 

intr 

The 

kill 

The 

lnext 

The 

quit 

The 

rprnt 

The 

stop 

The 

susp 

The 

werase 

The 


Flow Control 

In your terminal session with the UNIX system, before you start C-Kermit, you should en¬ 
sure that your UNIX login terminal device is using the same kind of flow control as your 
local terminal or emulator. For example, if your local terminal is using Xon/Xoff software 
flow control, then your UNIX session should be using it too. This can help prevent loss of 
data and fractured screens during your terminal session. Use the stty command to check 
whether Xon/Xoff flow control is enabled for your UNIX session. The Xon/Xoff charac¬ 
ters are shown in the “stop” field of the stty report. If they are missing, you can enable 
them with a command like: 

$ stty ixon ixoff 

Consult man stty for details specific to your UNIX system. 

If you are entering UNIX through a terminal server, you might find that Xon/Xoff flow 
control does not work promptly enough to prevent loss of data. In that case, you can en¬ 
able it at the terminal server rather than at your UNIX session. For example, at the prompt 
of a Cisco terminal server, use: 
ts> terminal flowcontrol software in out 

However, this prevents transmission of Ctrl-S and Ctrl-Q characters as data, as required 
by certain UNIX applications such as the EMACS editor. 

Some UNIX systems also support hardware flow control, most commonly RTS/CTS, but 
in most cases it won’t be used unless you request it. In certain UNIX versions, like Dell 
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System V Release 4, a login terminal must be permanently configured by the system 
manager for hardware flow control. In others, you can enable or disable hardware flow 
control by giving a UNIX command after you have logged in. Consult your system’s 
“man pages” to find out the proper incantation. Here are some examples: 

$ stty crtscts (SunOS 4.0 or later) 

$ stty rtsxoff ctsxon (System V R4, some versions) 

If you are entering UNIX through a terminal server, you might be able to enable hardware 
flow control there. On a Cisco terminal server, for example, the command is: 

ts> terminal flowcontrol hardware in out 

When C-Kermit is active, it attempts to use the type of flow control you have specified in 
your most recent set FLOW command (Xon/Xoff by default). Hardware flow control, 
however, is often available only through the use of tricks that C-Kermit might not know 
about, for example stty commands like the ones just shown, special device names such 
as /dev/ttyOOh instead of /dev/ttyOO, or /dev/cufa instead of /dev/cua. 
Once again, consult your system documentation for details. 

It can’t be stressed enough that terminal connection and file transfer work best when an 
effective flow control method is active. Hardware flow control, if available, should be 
used in preference to software flow control. 

Using International Characters in UNIX 

Even though C-Kermit has extensive facilities for handling and converting character sets, 
you can’t depend on UNIX itself for any help in this area. Older versions of UNIX do not 
support 8-bit no-parity terminal connections. They give you 7-bit terminal connections 
with even parity, restricting you to using only ASCII or a 7-bit national character set 
during your UNIX terminal session. UNIX terminal drivers make no provision, such as 
Shift-In/Shift-Out, for use of 8-bit characters in the 7-bit communications environment. 

There is, however, a movement afoot to make new versions of UNIX “8-bit clean” so 
8-bit character sets such as the ISO Latin alphabets can be used. 8-bit cleanliness is a 
standard feature of the NeXT workstation and of Dell UNIX SVR4/386 Issue 2.1. It is 
also available in SunOS 4.1 and ULTRIX 4.0, but it must be enabled by command: 

$ stty pass8 

Other UNIX systems might or might not be 8-bit clean. Try stty pass8, stty 
-parenb cs8, or stty -parity. Check your UNIX system manuals or man stty 
for details. If you are accessing UNIX from a terminal or emulator, make sure that it is 
also set up for 8 data bits and no parity, as well as for the character set you want to use. If 
you are coming into UNIX through a terminal server or network connection, make sure 
that it is set up for 8-bit transparency too; for example, use rlogin -8 rather than 
rlogin. 
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Program Control 

C-Kermit is a character-mode application designed to be used from a terminal. If you are 
accessing your UNIX system from a terminal or terminal emulator, you can start the Ker- 
mit program in the normal way; that is, by typing its name possibly followed by command 
line arguments. Then you can have an interactive dialog with it, using your keyboard and 
screen in the traditional manner. 

If you have a desktop UNIX workstation with a mouse-and-window-oriented graphical 
user interface (GUI) such as Motif, NeXTStep, SunView, DECwindows, AIX Windows, 
and the like, you might find that clicking on C-Kermit in the File Browser, File Viewer, or 
whatever else it might be called in your windowing environment, does not work well. 
Some workstations complain that C-Kermit is not a (name-of-GUI) application. Others 
might automatically create a terminal window for C-Kermit, but one that does not have all 
the features of a UNIX terminal device, in which case C-Kermit will not work correctly. 
This happens, for example, on the NeXT. 

The best way to start Kermit in a GUI environment is first to open a terminal emulation 
window that gives you the UNIX shell prompt, then start Kermit in the normal way from 
the shell prompt. On some systems you can write a shell script to do this, then you can 
click on the shell script in your GUI environment. See the ckuker. bwr file for ideas. 

Starting C-Kermit 

To start C-Kermit, just type “kermit” at the shell prompt: 

$ kermit 

C-Kermit 5A(188) 23 Nov 92, 4.4 BSD 
Type ? or HELP for help 
C-Kermit> 

If you get a message like “not found” rather than C-Kermit’s herald and prompt, it means 
that C-Kermit’s directory is not in your PATH (in which case you should change the 
PATH definition in your login profile to include it), or it is called by some other name 
(such as “wermit” or “ckermit”), or it isn’t there at all. If you get a message like “cannot 
execute” or “permission denied,” C-Kermit is installed incorrectly. Review the instal¬ 
lation instructions in the file ckuins . doc, or show them to whoever is responsible. 

Initialization File 

UNIX C-Kermit’s initialization file is called . kermrc. Because the name begins with a 
period, it is a hidden file and normally does not show up in directory listings, and it is nor¬ 
mally immune from rm * operations. The . kermrc file must be located in your home 
(login) directory. We recommend that you use the standard C-Kermit initialization file; 
create a separate file called .mykermrc to make any desired personal customizations. 
Your dialing directory file, if any, should be called . kdd and your services directory file 
should be . ksd, both in your home directory. 
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Redirection of Input and Output 

C-Kermit reads its interactive-mode commands from the standard input device, normally 
your keyboard, and prints its messages on the standard output device, your screen. To 
redirect Kermit’s standard input to come from a file, use the < operator on the UNIX com¬ 
mand line: 

$ kermit < kermit.tak 

In this example, the file kermit. tak contains Kermit commands. Kermit executes them, 
one after the other, until it comes to the end of the file (or to a QUIT or exit command), 
and then it exits back to the system prompt. 

You can also redirect Kermit’s screen output to a file using similar mechanisms: 

$ kermit > kermit.log 

Of course, redirecting Kermit’s screen output without also redirecting its input doesn’t 
make much sense, because then you’ll be typing Kermit commands to a blank screen. To 
redirect both input and output: 

$ kermit < kermit.tak > kermit.log 

You can even feed commands to Kermit from another process, if your mind is agile 
enough to conceive of a reason to do this: 

$ qrep '’send cmdfile 1 sort I kermit 
Background Operation 

If you’re using Kermit in local mode, you can have it transfer files in the background 
while you do other work in the foreground. This can be accomplished by redirecting 
Kermit’s standard input and output to command and log files and terminating the shell 
command that invokes Kermit with an ampersand: 

$ kermit < cmdfile > logfile & 

C-Kermit makes various system-dependent tests to see if it is running in the background. 
If it concludes that it is, prompts and most messages are not issued. If you start Kermit in¬ 
teractively but get no prompt after the greeting is printed, that means your operating sys¬ 
tem is reporting the symptoms of background operation even though Kermit is in the fore¬ 
ground. In such cases, you can force Kermit to behave as though it were in the foreground 
by including the -z command-line option: 

$ kermit -z 

C-Kermit 5A(188) 23 Nov 92, MIPS RISC/OS 

Type ? or HELP for help 

C-Kermit> 

Don’t use the -z option if you really are starting C-Kermit in the background. 
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Interrupting C-Kermit 

C-Kermit can be interrupted at its prompt, while typing a command, during execution of 
any command except CONNECT or remote-mode file transfer, and during local-mode file 
transfer by typing C-Kermit’s interrupt character, which is normally Ctrl-C. The interrupt 
character should echo as A c_and it should return you to the C-Kermit prompt immedi¬ 

ately if you were running C-Kermit interactively, or back to the system prompt if you 
started C-Kermit with command-line action options (Chapter 14). 

If Ctrl-C does not interrupt C-Kermit, use the UNIX stty command as described on page 
384 to find out what your UNIX intr character is. Use that character instead or change 
your interrupt character to Ctrl-C. 

To interrupt C-Kermit during remote-mode file transfer, type two Ctrl-C characters in a 
row. Ctrl-C is always used for this purpose, no matter what your interrupt character is. 
To interrupt C-Kermit during CONNECT mode, use the CONNECT-mode escape character, 
followed by the letter C to get back to the prompt, or any of the other escape-level com¬ 
mands described in Chapter 4. 

Suspending C-Kermit 

On UNIX systems with job control (generally those that are based on Berkeley UNIX, 
AT&T UNIX System V R4, or POSIX), you can suspend Kermit by typing Ctrl-Z or 
whatever your suspend character is (you can find out by using the stty command as 
described on page 384; your suspend character is listed under susp): 

C-Kermit> A Z 

[4] + stopped (signal) kermit 
$ 

You can suspend C-Kermit this way at any time except when it is in CONNECT mode or 
engaged in remote-mode file transfer. When at C-Kermit prompt level, you can also 
suspend Kermit by using the SUSPEND command: 

SUSPEND 

Suspends C-Kermit. Stops C-Kermit and returns to the system prompt, but does not 
remove C-Kermit from memory. Synonym: Z. 

SET SUSPEND { ON, OFF } 

ON, the normal setting, means C-Kermit handles SUSPEND signals if it was built in an 
environment that supports them. OFF means C-Kermit ignores SUSPEND signals. 

After you have suspended C-Kermit, you can get back to it by using the UNIX f g (fore¬ 
ground) command with Kermit’s job number (as shown when you suspended Kermit, and 
also shown by the shell’s jobs command) preceded by a percent sign: 

$ fg %4 
C-Kermit> 
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or its process number (as shown by the UNIX ps command). If Kermit was executing a 
command, it should resume where it left off. If it was at the prompt, you should get a new 
prompt. If you type “kermit” again, instead of “fg”, you will start a new copy of Kermit; 
the old one will still be sitting in the background. 

WARNING: The UNIX version of C-Kermit allows itself to be suspended and 
continued if the underlying operating system supports this feature. But (and this 
is a big But), you should not attempt to suspend Kermit or any other program if 
your UNIX shell does not also support this feature (Kermit cannot tell). Most 
C-Shells and K-Shells do, but most Bourne shells do not. 49 If you suspend 
C-Kermit in an environment that does not properly support job control, your 
session might become hopelessly hung. Your login session must be killed from 
another terminal (use the UNIX ps and kill commands). 

There are three ways to deal with this problem: 

1. Use a shell that supports job control. At most sites, you can use the chsh command 
to choose a different shell. For example, to use the C-Shell (csh): 

$ chsh csh 

Type man chsh for further information. 

2. Give C-Kermit the command SET SUSPEND OFF to make C-Kermit ignore the suspend 
signal: 

C-Kermit> set suspend off 

3. Disable the suspend signal before starting C-Kermit: 

% stty susp undef 

Fixing Your UNIX Login Terminal Modes 

If C-Kermit exits abnormally, for example because it was halted from another terminal, 
your login terminal might not function normally. In particular, it might not echo the 
characters you type and it might not recognize the Return or Enter key as a command ter¬ 
minator. In such cases, you should be able to restore your terminal to normal operation by 
issuing the reset or stty sane command (depending on your UNIX version). Type 
Ctrl-J, then the characters of the command, and terminate with another Ctrl-J (not Return 
or Enter). 


49 An exception is the Bourne shell distributed with AT&T System V Release 4. 
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UNIX C-Kermit Command Procedures 

When creating a shell script program in UNIX, you can specify which shell (such as sh, 
csh, or ksh) is to execute the program by including a special type of “comment” as the 
first line, for example: 

#I/bin/ksh 

The # character is the shell comment introducer, and the second character, l, tells the shell 
that the rest of the line gives the name of the program that should be run to execute the 
shell script. The example tells your current shell to start /bin/ksh and to feed the file 
into ksh’s standard input. 

C-Kermit follows the same convention, which is possible because the # character is not 
only a UNIX shell comment introducer but also, by happy coincidence, a C-Kermit com¬ 
ment introducer. If you put a line like this: 

#1/usr/local/bin/kermit 

at the beginning of a C-Kermit command file and you also give execute permission to the 
file, you can run the file simply by typing its name at the system prompt, just as you 
would run a shell script. But in this case, the shell feeds the file to Kermit rather than to a 
UNIX shell. Of course, you can also use C-Kermit’s TAKE command to execute the same 
file, in which case the #! line is ignored. 

On your own UNIX system, substitute the actual pathname of the Kermit program if it is 
not /usr/local/bin/kermit. To give execute permission to the command file, use the 
chmod +x command at the UNIX shell prompt: 

$ chmod +x cmdfile 

The commands in the file are executed after your initialization file has been completely 
processed, but before the C-Kermit prompt appears. If you want the command file to exit 
to the system without issuing the C-Kermit prompt, include an EXIT command at the end. 

You can also include C-Kermit command-line options in the command file invocation: 

$ cmdfile -p e -1 /dev/ttyh8 

or, to have C-Kermit skip its initialization-file processing: 

$ cmdfile -Y 

When you start Kermit from a command file, the UNIX shell constructs a command of 
this form: 

kermit-path-name command-file-name options 
so you can also invoke Kermit like this yourself, for example: 

$ kermit cmdfile -p e -1 /dev/ttyh8 
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Terminal Connection 

In the UNIX version of C-Kermit, terminal emulation is provided by your console driver, 
workstation terminal window, terminal emulator, or terminal. C-Kermit does not, itself, 
provide any particular type of terminal emulation beyond what is described in Chapter 4. 


The CONNECT-Mode Escape Character 

UNIX C-Kermit's default cONNECT-mode escape character is CtrlA (Control-Backslash) 
except on certain workstations (such as the NeXT) that cannot generate this character 
from the keyboard, in which case Ctrl-] (Control-Rightbracket) is used. Use SHOW 
escape to find out what your escape character is, and SET ESCAPE to change it. 


Key Mapping 

C-Kermit’s SET key command is effective only with keys that generate single-byte 7-bit 
or 8-bit codes. 7-bit keycodes are supported by C-Kermit for all UNIX versions, provided 
C-Kermit was configured with the key-mapping feature. 8-bit codes can be used if you 
have a keyboard capable of generating them, if C-Kermit has a clean 8-bit path to the 
keyboard, and if you have told C-Kermit to set command bytesize 8. 


Suspending C-Kermit While in CONNECT Mode 

During terminal connection, you can follow the CONNECT-mode escape character by the 
letter Z to suspend Kermit. This stops Kermit without breaking the connection and returns 
you to the same UNIX shell that you started Kermit from. Unlike the I option, the z op¬ 
tion lets you get at any other jobs (text editors, mail programs, etc.) that you might be run¬ 
ning in parallel with Keimit. Use the UNIX f g command to continue Kermit*s CONNECT 
session, as in this example: 


C-Kermit>connect 
% 

% A \ z 

[3] + Stopped (signal) 
$ 

$ jobs 

[3] + Stopped (signal) 

[2] - Stopped 

[1] Stopped (signal) 


(CONNECT to remote host) 

(Remote system prompt is %) 

(Suspend Kermit) 

kermit 

(Back at local system, prompt is $) 
(List my jobs) 

kermit 

emacs 

mm 


(Here you can run other programs, 
continue your background jobs, etc.) 

$ 

$ fg %3 (Restart C-Kermit) 

% (Connect session continues) 

% 


The usual cautions apply here. Don’t try to suspend C-Kermit if it was invoked from a 
shell that does not support job control. 
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File Transfer 

UNIX C-Kermit offers the full range of file transfer features, including text and binary 
transfers, file groups, attributes, and the fullscreen file transfer display if it has been 
configured in your version (use the CHECK FULLSCREEN command to find out). For text 
files, UNIX record format (lines terminated by LF) is automatically converted to Kermit’s 
standard intermediate form (CRLF) during file transfer. 

If your version of UNIX C-Kermit was built with the DYNAMIC compilation option (use 
CHECK dynamic to find out) you have approximately 9000 bytes of packet buffer allow¬ 
ing, for example, a window size of 9 and a packet length of 1000, or a window size of 18 
and a packet length of 500. You can use the SET buffers command to increase the buffer 
size to allow more window slots or longer packets, for example: 

C-Kermit >set buffers 80000 80000 
C-Kermit> set window 20 

C-Kermit> set receive packet-length 4000 

If your C-Kermit was built without the dynamic feature, your packet buffer size is 
restricted to approximately 3000. 

Interruption of Local-Mode File Transfer 

In most C-Kermit versions, you can interrupt a local-mode file transfer by typing single 
letters like X, Z, or E (see Chapter 5). In C-Kermit versions based on AT&T System V 
UNIX or in POSIX, however, you must type the CONNECT-mode escape character (nor¬ 
mally Ctrl-Backslash) before you type the interruption key. 50 C-Kermit’s message at the 
start of file transfer gives you the information you need. Example: 

C-Kermit> s oofa.txt 
SF 

Type escape character (*\) followed by: 

X to cancel file, CR to resend current packet 

Z to cancel group, A for status report 
E to send Error packet, Ctrl-C to quit immediately: 

A 

Sending: oofa.txt => OOFA.TXT 
Size: 20659, Type: text 

. Ctrl-\X 

Cancelling File [interrupted] 

ZB 

C-Kermit> 

In this case the escape character was Control-Backslash, so the user typed Ctrl-\ followed 
by the letter X to interrupt the file transfer. 


50 The control-character prefix is required because of limitations in the System V and POSIX terminal 
drivers. Nevertheless, your version of C-Kermit might include a workaround, so also try entering the 
interruption characters without the control-character prefix. 
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Background File Transfer 

On UNIX systems with job control, you can type your suspend character (normally 
Ctrl-Z) to suspend Kermit during local-mode file transfer. This stops Kermit so you can 
talk to your shell or run other programs. Later (but not too much later) you can bring it 
back in the foreground (using the UNIX f g command); the file transfer resumes where it 
left off, provided the other Kermit has not timed out. 

C-Kermit> s order.log 
SF 

Sending: order.log => ORDER.LOG 
Size: 3712745, Type: text 

X to cancel file, CR to resend current packet 
Z to cancel group, A for status report 
E to send Error packet, Ctrl-C to quit immediately: A 
. Ctrl-Z 

[3] + Stopped (signal) kermit 


$ fortune (Quick, I need a fortune) 

The moon is full. Today is your lucky day. You are very hungry. 

$ fg %3 (Resume Kermit) 

kermit 

N%. [OK] 

ZB<BEEP> 

C-Kermit>exit 


You can also continue the file transfer in the background, leaving your terminal free for 
other work in the meantime: 

. Ctrl(Z) 


[3] + Stopped (signal) 

kermit 

$ bq %3 

(Continue Kermit in the background) 

[3] kermits 


$ "jobs 


[3] + Running 

kermit 

[2] - Stopped 

emacs 

[1] Stopped (signal) 

mm 

Eventually, your shell will give you a message that the job has stopped because it wants 


“tty input,” which means the transfer has completed. At that point you can put Kermit 
back in the foreground: 

[3] + Stopped (tty input) kermit 

$ fq %3 (Back to the foreground) 

C-Kermit> (Prompt reappears) 

Sending Files 

C-Kermit processes wildcard characters (metacharacters) in the SEND and MSEND com¬ 
mands, and the C-Kermit server also processes them when it receives a GET command. 

UNIX C-Kermit offers two options for processing wildcards: its own internal wildcard ex¬ 
pander and that of your shell. Select the desired expansion method with this command: 
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SET WILDCARD-EXPANSION { KERMIT, SHELL } 


Unless you say otherwise, Kermit expands wildcards itself. In this case, three special 
characters are recognized and expanded: 

- (Tilde) (at the beginning of a filename only) is translated into your login directory 
name (if followed immediately by a slash) or into the login directory of the user whose 
username immediately follows the tilde: 

C-Kermit> send -/.profile (My own .profile file) 

C-Kermit> send -jrd/mskermit.ini (JRD's mskermit.ini file) 

* (asterisk) Matches zero or more characters within a file or directory name. The as¬ 
terisk does not match the slash (/) character; that is, it does not work across directory 
separators. 

C-Kermit >send * (All files in current directory) 

C-Kermit> send -/*/*.ini (.ini's in all subdirectories) 

C-Kermit> send o*a (o-anything-a) 

In UNIX, “hidden” files (whose names begin with a period character), such as 
. login, are not sent unless the filespec also begins with a period : 51 

C-Kermit> send * (All nonhidden files) 

C-Kermit> send . * (All hidden files) 

C-Kermit> msend * .* (All files) 

? (question mark) Matches any single character except a directory separator (slash) or 
the leading period of a hidden file. You must quote the question mark with a back¬ 
slash to override its normal help-giving function: 

C-Kermit> send ckcker.\? (ckcker.l-character) 

C-Kermit> send ckcker.\?\?\? (ckcker.3-characters) 

C-Kermit> send -kermitA?* (-kermit/-at-least-l-character) 

If you don’t quote the question mark, you get a list of matching filenames, and then 
you are reprompted with what you have typed so far: 

C-Kermit> send ckcmai.? File(s) to send, one of the following: 

ckcmai.c ckcmai.o 

C-Kermit>send ckcmai. 

The UNIX shells csh, ksh, and bash, but not the original Bourne shell, provide additional 
filename-matching wildcard characters. If you SET WILD SHELL, Kermit uses the shell 
whose file specification is given in the SHELL environment variable: 

$ echo $SHELL 
/bin/ksh 


51 This is compatible with the file matching of the UNIX shell and the Is command. 
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or if that fails, it uses your login shell (as recorded in the etc/passwd file). Internally, 
Kermit uses the specified shell’s echo command to expand metacharacters. Exactly 
which metacharacters are available depends on your shell and its echo command. The 
following are generally available in addition to those listed; consult your shell’s “man 
page” for further information. 

[abc] 

(csh, ksh, bash) Matches any single character that appears within the brackets: 
C-Kermit> send ckfcuwl*.Tcwhl (The UNIX Kermit source files) 

[a-z] 

(csh, ksh, bash) Matches any single character in the range indicated in the brackets, 
in this case a through z. The characters in the range are determined by the internal 
numeric codes for the characters (for example their ASCII values): 

C-Kermit> send x[ 0-9][0-9].log (xOO.log thru x99.log) 
C-Kermit> send fFf1fIi]fLl]fEel ("file" in any case) 

{aaa,bbb} 

(csh, bash) Matches any of the comma-separated character strings within the braces: 

C-Kermit> send ckcker.{upd,bwr> 

C-Kermit> send {oofa.txt,hex.c> 

C-Kermit >send ck[cuw1 *.{[cwh],doc,bwr,nr > 

As you can see, shell expansion can be more flexible than Kermit’s own, and it is consis¬ 
tent with your own use of your preferred shell. But it also has several possible drawbacks: 

• It might be difficult or impossible to refer to files whose names contain shell 
metacharacters. (Try quoting such characters with a backslash or two, or enclosing 
the filename in doublequotes, but this might not always work.) 

• The same Kermit file transfer command might behave differently depending on what 
your current shell is. This is a particularly important consideration for command files. 
Kermit’s internal expansion, on the other hand, works consistently. 

• The echo command of certain shells (notably csh) might print not only filenames, but 
other words. For example, in the C-Shell: 

$ echo foo* 
echo: no match 

In this case, if you happen to have files called echo:, no, or match, Kermit might try 
to transfer them. 

• The echo command has an option -n. If you try to refer to a file whose name is -n, 
you must prefix it with a directory specification (for example, . /-n) to prevent echo 
from interpreting its name as a command option. 
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When you give the -s option on the C-Kermit command line, the file specification that 
follows can include any wildcard notation that is understood by your shell, regardless of 
C-Kermit’s WILDCARD-EXPANSION setting. The shell expands wildcards into a list of files 
that is provided to Kermit via the “argv” mechanism. For example: 

$ kermit -s *.txt 

The shell, not Kermit, expands *. txt into a list of all the files in your current directory 
whose names end with “ .txt”. If any of the files actually contains a wildcard character 
as part of its name, C-Kermit makes no attempt to expand it further. 

Receiving Files 

Incoming files are stored in the current directory unless you told the RECEIVE command 
otherwise or if the incoming file header packet includes a pathname. A file can be created 
only if you have write access to the directory where the file is to be stored. If a file of the 
same name already exists in the target directory, and C-Kermit’s file collision is set to 
backup or overwrite, you must also have write access to the previously existing file. 
C-Kermit will not create or delete files for you that you could not otherwise create or 
delete yourself. 

Files are stored with the permissions of the containing directory combined with your 
“umask” (see the “man page” for your shell for further information). In other words, 
C-Kermit creates files with exactly the same permissions they would have if you created 
them any other way, for example with the cat command, or with a text editor. 

C-Kermit does not set execute permission on incoming files. If you are using C-Kermit to 
receive shell scripts, executable binary programs, or other types of files that require ex¬ 
ecute permission, use chmod +x after the transfer. 

If a UNIX file must be renamed because of your file collision setting, C-Kermit ap¬ 
pends a pseudo-version-number to the end of the file’s name: 
oofa.-n- 

where oof a is the name the two files share and . ~n~ is a version number, for example: 
resume.mss.~8~ 

If oof a exists, the new file is called oof a. -1-. If oof a and oof a. -1- exist, the new 
file is oof a. - 2-, and so on. If the new name would be longer than the maximum length 
for a filename on your UNIX system, then characters are deleted from the end first. For 
instance, thelongestname on a system with a limit of 14 characters would become 
thelongest .-1-. This scheme is compatible with the backup mechanism used by 
GNU EMACS on UNIX, and in fact the renamed files are recognized as backup files by 
EMACS, which can be used to clean up excessive numbers of them. 
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Appendix IV 


VMS C-Kermit 


oooo 

This appendix explains how to use C-Kermit on a Digital Equipment Corpora¬ 
tion VAX or AXP computer with the VMS or Open VMS operating system. For 
a current list of limitations and restrictions of VMS C-Kermit, also read the files 
CKCKER. BWR and CKVKER. BWR provided with the VMS C-Kermit distribu¬ 
tion files. 

VMS (Virtual Memory System) is the operating system for Digital Equipment Corpora¬ 
tion 32-bit VAX (Virtual Address Extended) computers, a product line ranging from 
desktop workstations to minicomputers to large mainframes. VMS is a multiuser, multi¬ 
tasking operating system. Open VMS is the new name for the VMS operating system; 
Open VMS runs on both VAX and AXP processors. C-Kermit runs under both VMS and 
Open VMS, on both VAX and AXP processors. In this appendix, the word VMS also in¬ 
cludes OpenVMS on both VAX and AXP architectures. 

Preparing Your VMS Session for C-Kermit 

Before starting C-Kermit, make sure that VMS knows what kind of terminal you have so 
C-Kermit’s FULLSCREEN file transfer display will work correctly. VMS C-Kermit (like 
VMS itself) supports only the VT52 and VT100 and higher terminal types for formatted 
screen display functions. If you are using C-Kermit on a terminal that is not compatible 
with these terminals, you should not use Kermit’s FULLSCREEN file transfer display. 


399 





VMS is designed to be used from DEC terminals. When you log in, most VMS systems 
send a special “What Are You?” query (the ESC character followed by the letter Z) to the 
terminal. All DEC terminals respond automatically with a character sequence indicating 
the terminal model—LA36, VT52, VT100, VT200, VT300, VT400, etc. If you are using 
a VT or compatible terminal, or a PC with a correctly functioning VT terminal emulator, 
such as MS-DOS Kermit, your VMS terminal type is set automatically. Otherwise, there 
is a lengthy pause while VMS waits for a valid reply, doesn’t get one, and then sets your 
terminal type to unknown. 

You can find out what terminal types are supported by your VMS system by issuing the 
VMS command HELP SET terminal/device. If your terminal appears on this list, you 
can give a VMS command to set your terminal type correspondingly, like: 

$ set terminal /device=vtlOO 

You can find out your VMS terminal characteristics with the SHOW TERMINAL command. 

If you are using a speaking device or a TDD (Telecommunication Device for the Deaf), 
you should choose a hardcopy terminal type, such as LA36. 

Checking and Setting Your Communication Speed 

When you use C-Kermit to transfer files in remote mode, it bases its packet timeouts on 
the communication speed of your login terminal as reported by VMS. If you have dialed 
in at (say) 2400 bps but VMS thinks your speed is 19200 bps, file transfers might not 
work well, or at all. 

VMS knows your communication speed if your terminal or PC is connected directly, or 
through a modem, to a communication port on the VMS system. If you give the SHOW 
terminal command, you’ll see a display like this: 

$ sho term 

Terminal: _TXA3: Device_Type: VT300_Series Owner: IVAN 

Input: 2400 LFfill: 0 Width: 80 Parity: None 

Output: 2400 CRfill: 0 Page: 24 

If you have entered the VMS system through a network connection—a terminal server 
using TCP/IP TELNET or RLOGIN (but not LAT) protocol, or a TELNET or RLOGIN (but not 
cterm) session from another host—you are not attached to a real communication port, so 
VMS might not know your true communication speed. Check to see: 

$ sho term 

Terminal: _NTY2: Device_Type: VT300_Series Owner: IVAN 

Remote Port Info: watsun.cc.columbia.edu 

Input: 19200 LFfill: 0 Width: 80 Parity: None 

Output: 19200 CRfill: 0 Page: 24 


400 VMS C-Kermit / Appendix IV 




If the speed is wrong, you should let VMS know your true speed as soon as you log in (but 
don’t do this on a LAT connection): 

$ set term /speed=1200 

Using International Characters 

If the communication channel between you and the VMS system permits transmission of 
8-bit data, you can use 8-bit character sets such as ISO Latin-1 and the DEC Multinational 
Character Set in your VMS session. VMS applications support the use of 8-bit characters, 
but you might have to tell VMS that your terminal is able to use them. The command is: 

$ set terminal /noparity /eight 

If you can’t obtain an 8-bit connection, you are restricted to a 7-bit character code during 
terminal operations. This code may be ASCII or any other 7-bit code supported by your 
terminal or terminal emulator, such as an ISO 646 national character set. 

Using VMS C-Kermit 

VMS users might find C-Kermit’s command processing to be somewhat unfamiliar. It 
lacks certain VMS features and has some others that you will soon wish VMS had. 
C-Kermit’s “user interface” is intended to be compatible with other Kermit programs, 
rather than with a particular operating system. Once you have learned to control one Ker¬ 
mit program, you will also be conversant with most others. 

Program Control 

C-Kermit is a character-mode application designed to be used from a terminal. If you are 
accessing your VMS system from a terminal or terminal emulator, you can start the Ker¬ 
mit program in the normal way, that is, by typing its name possibly followed by command 
line arguments. 52 Then you can have an interactive dialog with C-Kermit, using your 
keyboard and screen: 

$ kermit 

C-Kermit 5A(188) 23 Nov 92, OpenVMS VAX 

Type ? or HELP for help 

C-Kermit> 

If you have a desktop VMS workstation with a mouse-and-window-oriented graphical 
user interface (GUI) such as DECwindows, you should run C-Kermit in a VT terminal 
emulation window, also known as a DECterm. 


52 Or, if Kermit has not been installed as a system command, use the run command. The run command, 
however, does not permit command-line arguments. 
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Command-line options are converted to lowercase before C-Kermit sees them, which can 
interfere with important case distinctions, for example between the -y and -Y or -c and 
-C options. To include an uppercase option on the VMS C-Kermit command line, enclose 
it in doublequotes: 

$ kermit "-Y" 

Interrupting C-Kermit 

C-Kermit can be interrupted at its prompt, in the middle of typing a command, during ex¬ 
ecution of any command except CONNECT or remote-mode file transfer, and during 
local-mode file transfer by typing either one of the VMS interrupt characters, Ctrl-C or 
Ctrl-Y. Both should have the same effect. 

The interrupt character should echo as A c_and return you to the C-Kermit prompt im¬ 

mediately (if you were running C-Kermit interactively), or else back to the system prompt 
if you started C-Kermit with command-line action options (Chapter 14). 

To interrupt C-Kermit during remote-mode file transfer, type two consecutive Ctrl-C 
characters. This should return you to the C-Kermit prompt or, if you started C-Kermit 
with command-line action options, to the VMS system prompt. 

To interrupt C-Kermit during CONNECT mode, use the CONNECT-mode escape character, 
followed by c to get back to the prompt, or any of the other escape-level commands 
described in Chapter 4. 

Redirection of Input and Output 

C-Kermit reads its interactive-mode commands from the standard input device, normally 
your keyboard, and prints its messages on the standard output device, which is normally 
your screen. To redirect Kermit’s standard input to come from a file, redefine the 
SYS $ INPUT logical name: 

$ define sys$input kermit.cmd 
$ kermit 

$ deassiqn sys$input 

In these examples, the file KERMIT.CMD contains C-Kermit commands. C-Kermit ex¬ 
ecutes them, one after the other, until it comes to the end of the file (or to an exit, stop, 
or similar command), and then it exits back to the system prompt. 

You can also redirect C-Kermit’s screen output to a file by redefining the SYS$OUTPUT 
logical name before starting C-Kermit: 

$ define sys$output kermit.log 
$ kermit 

$ deassign sys$output 
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But if you redirect Kermit’s screen output without also redirecting its input, you’ll be 
typing Kermit commands to a blank screen. To redirect both input and output: 

$ define sys$input kermit.cmd 
$ define sys$output kermit.log 
$ kermit 

$ deassign sys$output 
$ deassign sys$input 

Background operation in VMS can be accomplished with the spawn/nowait command: 

$ spawn /nowait /input=kermit.cmd /output=kermit.log kermit 
or by running Kermit in a batch job, using the VMS submit command. 

Running C-Kermit in DCL Command Procedures 

In a DCL . com file, lines beginning with dollar sign are commands that you would type at 
the VMS system prompt; all others are input for a program. The following example 
shows how to construct a DCL command file that feeds interactive-mode commands to 
C-Kermit. The first two lines are DCL commands, the next three are C-Kermit com¬ 
mands, and the last line is another DCL command: 

$ write sys$output "Starting Kermit..." 

$ kermit 

set file type binary 

receive 

exit 

$ write sys$output "Kermit finished." 

To make VMS C-Kermit read its commands from your keyboard when invoked from a 
DCL command procedure, include the following redefinition of the SYSSCOMMAND logi¬ 
cal name: 

$ write sys$output "Starting Kermit..." 

$ define /user sys$input sys$command 
$ kermit 

$ write sys$output "Kermit finished.” 

DCL command procedures can pass their command-line arguments along to C-Kermit. 
For example, the following DCL command file, KSEND.COM, sends up to eight files (or 
groups of files) from a remote VMS system to the user’s local Kermit program: 

§ kermit -s 'pi' 'p2' 'p3' 'p4' 'p5' 'p6' 'p7' 'p8' 

The p’s in single quotes are DCL variables, similar to Kermit’s macro argument variables. 
They are used here to pass command-line arguments from the DCL command procedure 
to C-Kermit. To use this command procedure, type (for example): 

$ @ksend ckvker.mak ck*.h ck*.c 

This example assumes the KSEND. COM file is in your current directory. 
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The C-Kermit Initialization File 

VMS C-Kermit identifies its initialization file by the following steps: 

1. The file ckermit . ini, if it exists, in the directory designated by the system-wide 
logical name ckermit_ini t, if it is defined. You can override the system-wide 
definition, if any, by redefining this logical name. 

2. The file designated by the logical name CKERMIT_INIT, if it is defined. 

3. The file ckermit . ini in your login (home) directory. 

If the ckermitjni logical name does not exist, or does not turn up a ckermit.ini file, 
then the search proceeds down the list. 

The system manager can install the standard C-Kermit initialization file in a central loca¬ 
tion and define the system-wide logical name ckermit_ini to identify the directory where 
this file is. To institute site-wide customizations, a C-Kermit command file called 
ckermit . SYS can be placed in the same directory as the system-wide ckermit . ini file. 

The standard initialization file automatically executes the user’s own customization file, 
ckermod.ini, if it exists in the user’s home directory, so each user can create a personal¬ 
ized C-Kermit environment without having to duplicate the common material from the 
standard initialization file. 

Users can further customize C-Kermit to use different settings when started from different 
directories. For example, you can put a CKERMIT. INI file in your BINARIES directory to 
SET FILE TYPE BINARY, and another one in your TEXT directory to SET FILE TYPE TEXT. 
Then include the following as the last line in your login directory’s CKERMOD. INI file: 

if not equal \v(home) \v(dir) - 

if exist []ckermit.ini take [jckenuit.ini 

If you have a dialing directory file, it should be installed in your login directory with the 
name ckermit. kdd. If you have a services directory file, it goes in the same place under 
the name ckermit . ksd. 

Terminal Connection 

VMS C-Kermit’s default cONNECT-mode escape character is CtrlA (Control-Backslash). 
Terminal emulation is provided by your console driver, workstation terminal window, ter¬ 
minal emulator, or terminal. VMS C-Kermit recognizes keystrokes as single 7- or 8-bit 
bytes. 8-bit codes can be used if you have a keyboard capable of generating them, if 
C-Kermit has a clean 8-bit path to the keyboard, if you have told C-Kermit to SET 
COMMAND and TERMINAL BYTESIZE 8, and if your VMS terminal has the EIGHTBIT charac¬ 
teristic, as shown by the VMS SHOW TERMINAL command. 
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File Transfer 

VMS C-Kermit transfers most common types of files in the correct manner automatically, 
with no SET file type commands required. When sending files, VMS C-Kermit supports 
the full range of VMS wildcard characters for file group selection. 

Wildcards 

VMS lets you refer to groups of files in a single file specification by using wildcard 
characters. VMS wildcard characters are asterisk (*) and percent (%). Asterisk matches 
all or part of a directory name, file name, or file type. It can also be used to stand for all 
version numbers, but it cannot be used to match part of a version number. In the directory 
field, the asterisk does not operate across the periods that separate directory names. Per¬ 
cent sign matches any single character in a directory name, file name, or file type, but it 
cannot be used in the version number field. The following command: 

$ directory [kermit.*1a*.%%%;0 

lists the names of the most recent versions (; 0) of all files whose names start with the let¬ 
ter A (alphabetic case does not matter in VMS filenames) and that have a three-character 
filetype, in all subdirectories of the [ kermit] top-level directory of the current disk. 

There are also two special wildcards for use with directory names. The ellipsis (...) 
means “from here all the way down,” and hyphen (-) means “one level up.” Two 
hyphens means two levels up, and so on. 

Here are some sample wildcard file specifications: 

$ dir [*] 

All files in all top-level directories 
$ dir [.*] 

All files in all directories immediately below the current directory (one level down) 

$ dir [...] 

All files in the current directory and all directories below it 

$ dir I OLGA.PROGRAMS...] 

All files in OLGA. PROGRAMS and all directories below it 

$ dir [-] 

All files in the directory immediately above the current directory (one level up) 

$ dir [—] 

All files in the directory two levels up 
$ dir [0000001 

All files in the root directory of the current disk (if you have access) 
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Sending Files from VMS 

When you are sending files from VMS C-Kermit, and its file type is set to text or 
binary, it chooses the mode of transfer automatically. The rules are: 

1. If the record format is Undefined, binary mode is used. 

2. If the record format is Fixed, and the file has no record attributes (the VMS 
directory/full command reports “Record attributes: None”), binary mode is used. 

3. If the record format is Fixed and the file has any record attributes (for example. Car¬ 
riage Return Carriage Control), text mode is used. 

4. In all other cases, including Stream and Variable record formats, text mode is used. 

VMS C-Kermit automatically tells the receiving Kermit the file’s type in an Attribute 
packet. This allows the receiving Kermit to interpret and store the file in the correct mode 
automatically if it understands Attribute packets (most modem Kermit programs do; see 
Table 1-1 on page 8). It also lets VMS C-Kermit send a mixture of text and binary files in 
a single send command. For example, you can send the C-language (text) source file 
OOFA.C and the (binary) executable OOFA.EXE together with one command: 

C-Kermit >send oofa.* 

When sending a text file, C-Kermit handles all combinations of record format and carriage 
control, including Fortran (ANSI) and Print, converting each into Kermit standard 
ASCII/CRLF stream format. It also translates the file’s character set according to any SET 
FILE CHARACTER-SET and SET TRANSFER CHARACTER-SET commands you have given. 

When sending a binary file, VMS C-Kermit does no interpretation, translation, or refor¬ 
matting of the file’s data. Record-length and carriage control fields are discarded, and no 
characters are inserted at record boundaries or at the end of the file. 

VMS C-Kermit also sends the file’s size and creation date and time in the Attribute 
packet. This allows the receiving Kermit program to reject the file if it is too big for avail¬ 
able storage and to set the file’s creation date to match the original or to take file collision 
actions based on the date. The reported size of a text file might differ from the actual size 
due to record format conversions. 

VMS C-Kermit also lets you include DECnet node names in filenames: 

C-Kermit> send netlab:;$diskl:f jrd.kermit]msvibm.boo 
C-Kermit> send spcvxa"TERRY\32PASS!/OH£>" ::kermitrckvcvt.c 
C-Kermit> receive cumin::lpt; 

The first example sends a publicly readable file from node NETLAB. The second ex¬ 
ample sends a file that is not publicly readable from node SPCVXA, so a valid user ID 
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and password for that node must be included as part of the node name. These must be 
given in uppercase and the space that normally separates the user ID and password must 
be entered as \32 to prevent C-Kermit from thinking that the space introduces the next 
field of the command. The final example receives a file to a publicly accessible line 
printer on DECnet node CUMIN and then prints it. 

If you invoke VMS C-Kermit with the command-line option to send files (-s, see Chapter 
14), wildcard characters are expanded internally by C-Kermit, using underlying VMS 
operating system services: 

$ kermit -s a*.* login.com ckermit.ini f.*1*.com 

This example sends all files in the current directory whose names start with A, plus 
login . com and ckermit. ini from the current directory, plus all . com files from all im¬ 
mediate subdirectories of the current directory. 

VMS C-Kermit sends the most recent version of each file unless you include a specific 
version number: 

C-Kermit> send folaflpaper.txt (Most recent version only) 

C-Kermit> sen [olaf1stone.txt;3 (A specific version) 

C-Kermit> s [olaflscissors.txt;* (All versions) 

Receiving Files 

When receiving files, VMS C-Kermit chooses between text and binary mode as follows: 

1. If the Kermit program that is sending the file to C-Kermit includes an Attribute packet 
specifying the file type (text or binary), C-Kermit uses the given type. 

2. If there is no Attribute packet, if the Attribute packet does not mention a file type, or if 
you have given the command set ATTRIBUTE TYPE OFF, C-Kermit uses your current 
FILE TYPE setting. 

VMS C-Kermit checks for sufficient free disk space if the remote Kermit supplies file size 
information. If there isn’t enough space on the disk, the file is rejected. User quotas are 
not checked. If the device for the received file is not a disk (for example, the system 
lineprinter) the file is assumed to fit. To defeat space checking, give the command SET 
ATTRIBUTE LENGTH OFF. 

Received text files are stored in “Sequential variable, carriage-return carriage control” 
format, with each line (record) terminated by carriage return and linefeed (CRLF). Lone 
carriage returns or linefeeds are stored within the record. 

Files received in binary mode are stored by C-Kermit in fixed 512-byte records. If the last 
record does not end on a 512-byte boundary, the exact end of the file is marked using the 
RMS “first free byte” construct. 
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If there is valid date and time information in the incoming Attribute packet, C-Kermit sets 
the new file’s creation date and time accordingly. The file is marked as being revised 
once (initial creation) on the current date and time to ensure that the file is backed up on 
the next BACKUP run. 

When the Automatic Methods Don’t Work 

oooo 

If you can successfully transfer both text and binary files to and from VMS with 
C-Kermit, feel free to skip the rest of this Appendix, which presents special 
methods for transferring the kinds of VMS files that C-Kermit does not handle 
automatically. 

VMS supports a wide variety of file formats. Information about each file is recorded in 
the file’s directory entry and, in most cases, also in the file itself. Most other computers 
have simpler file systems, with no natural way to record or represent VMS’s file types and 
attributes. When a complicated type of file is sent from VMS to, say, UNIX or MS-DOS, 
much of the VMS-specific information can be lost. When the file is sent back to VMS, it 
is no longer in its original format and might be unusable. Even when a file is transferred 
from VMS to VMS the results can be less than satisfactory if the transfer program can’t 
convey all the descriptive information along with its contents. 

Each VMS application defines its own data file formats. Everyday text-oriented applica¬ 
tions like the CREATE command and the editors EDT and EVE use ordinary text files: 
stream files with lines terminated by carriage return and line feed, the same as Kermit’s 
default for text files. The VMS operating system requires its executable program images 
to be in fixed 512-byte record format, the same as Kermit’s default for binary files. 

But the VMS linker requires its (binary) object files to have variable length records. A 
backup saveset must have fixed-length records with a record length of at least 2048 
bytes. A database file might have indexed or relative organization, rather than sequential. 
Some applications deliberately coerce their files into unusual formats to make it difficult 
for other applications to use them. File attributes such as record format and length can’t 
be handled by other operating systems like MS-DOS, OS/2, UNIX, or CP/M, so these files 
need special handling when you transfer them. 

You can find out the particulars of a VMS file with the DIR/FULL command, for example: 

$ dir /full oofa.obj 

Directory $DISK1:[OLGA] 

OOFA.OBJ;2 File ID: (3201,349,0) 

Size: 37/38 Owner: [USER,OLGA] 
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Created: 14-FEB-1992 14:20:55.17 
Revised: 14-FEB-1992 14:21:48.47 (1) 

Expires: <None specified> 

Backup: 8-FEB-1992 09:19:47.43 

File organization: Sequential 

File attributes: Allocation:38, Extend:10, Global buffercount:0 

No version limit 

Record format: Variable length, maximum 512 bytes 

Record attributes: None 
RMS attributes: None 

Journaling enabled: None 

File protection: System:RWED, Owner:RWED, Group:RE, World: 

Access Cntrl List: None 

Total of 1 file, 37/38 blocks. 

VMS C-Kermit lets you store incoming binary files with any record length you like in ei¬ 
ther fixed or undefined format, and it offers you two VMS-specific file types for transfer¬ 
ring VMS files that don’t fit the normal mold. 

Selecting the Record Length for Incoming Files 

When VMS C-Kermit receives a text file, it stores it on disk using variable-length records, 
one record per line, using carriage return and linefeed to delimit the lines. The maximum 
length for a line is 32,767 characters. If you try to send VMS C-Kermit a line of text 
longer than this, the file transfer will fail with the message “Error writing data.” 53 

Binary files, however, do not have lines and there is no automatic way for C-Kermit to 
sense record boundaries in arriving binary files. So unless you say otherwise, C-Kermit 
stores incoming binary files using fixed-length 512-byte records. When an incoming bi¬ 
nary file, such as a backup saveset, must be stored using some other record length, you 
can use the following command: 

SET FILE RECORD-LENGTH number 

Specifies the record length used by VMS C-Kermit to store an incoming file of type 
binary or image. The number can be up to 32767. 

The record length setting is ignored when sending files; VMS C-Kermit uses the file’s 
record length from its VMS directory entry. The record-length setting is also ignored 
when receiving text files. 

To illustrate, let’s create a backup saveset on disk and transfer it to a PC. Remember to 
take careful note of the file’s record length: 


53 This is a limitation of the VMS file system. If you really have a text file with lines longer than 32K, 
you can send it in binary mode. 
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$ backup oofa.* /interchange testing.bck /save 
$ dir /full testing.bck 

Record formats Fixed length 32256 byte records 
$ kermit 

C-Kermit> send testing.bck (Send the file) 

Alt-x (Escape back to the PC) 

MS-Kermit> receive (Receive the file) 

Note that no SET commands were necessary. VMS C-Kermit recognizes the file as binary 
because it has fixed-length records and automatically tells MS-DOS Kermit that the file is 
binary. 


Now let’s send the BACKUP saveset from the PC to a different VMS system and restore the 
files from it. The connection is already made and VMS C-Kermit is already started. The 
trick here is to tell VMS C-Kermit what record length to use when storing the file and to 
tell MS-DOS Kermit to send the file in binary mode, which also causes MS-DOS Kermit 
to tell C-Kermit that it is a binary file: 


C-Kermit> set file record-length 32256 (Use the same numberl) 
C-Kermit >receive (Wait for the file) 

Alt-x (Escape back to the PC) 

MS-Kermit> set file type binary (Use binary mode) 

MS-Kermit >send testing.bck (Send the file) 


(The file is transferred) 

MS-Kermit >connect (Go back to VMS) 

C-Kermit >exit (Quit from C-Kermit) 

$ backup testing.bck/save/log *.* (Restore the files) 

%BACKUP-S-CREATED, created OOFA.C;12 
%BACKUP-S-CREATED, created OOFA.H;3 
%BACKUP-S-CREATED, created OOFA.EXE;8 
%BACKUP-S-CREATED, created OOFA.OBJ;11 
$ 


If the record length had not been set correctly, backup would have become very upset 
when you tried to restore the files: 

%BACKUP-E-READERR, error reading TESTING.BCK 
-BACKUP-E-BLOCKCRC , software block CRC error 
%BACKUP-E-INVBLKSIZE, invalid block size in save set 
%BACKUP-E-INVRECSIZ, invalid record size in save set 
%BACKUP-E-INVRECSIZ , invalid record size in save set 
%BACKUP-E-READERRS, excessive error rate reading TESTING.BCK 
-BACKUP-I-HDRCRC , software header CRC error 
%BACKUP-I-OPERSPEC 

%BACKUP-I-OPERASSIST, operator assistance has been requested 
Not only has backup flooded your screen with complaints, it has also reported your mis¬ 
behavior to the system operator! 
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Storing Incoming Binary Files in Undefined Format 

We have said that VMS C-Kermit detects the transfer mode of an incoming file automati¬ 
cally if the Attribute packet information is given. If an incoming file is announced as bi¬ 
nary, C-Kermit normally stores it in Fixed format. But certain applications (such as Con¬ 
cept Omega Thoroughbred BASIC) require their files to be in Undefined format. VMS 
C-Kermit’s SET file type binary command has an optional trailing field to let you 
specify whether incoming binary files should be stored in Fixed or Undefined format. 
Here is a complete description of the SET FILE type binary command for VMS: 

SET FILE TYPE BINARY [ { FIXED, UNDEFINED J=FIXED ] 

Incoming files are to be processed in binary mode unless they are accompanied by an 
Attribute packet identifying their type as text. When receiving a binary file, C-Kermit 
stores it using fixed-length records (no length fields), with the record length specified 
in the most recent SET file RECORD-LENGTH command, 512 by default, and uses the 
RMS “first free byte” attribute to record the precise end of file. By default, the record 
format of the incoming file is set to Fixed. If you SET FILE TYPE binary undefined, 
the record format of the incoming file is set to Undefined instead of Fixed. Only the 
directory entry is affected by your choice of Fixed or Undefined, not the storage of the 
data itself. 

RMS, the VMS Record Management System, cannot deal with undefined-format files, so 
only use binary undefined if you have an application that requires it. Here is an ex¬ 
ample in which a Thoroughbred BASIC file is transferred from a PC to a VAX: 

$ kermit (Start Kermit on the VAX) 

C-Kermit 5A(188) 23 Nov 92, VAX/VMS 
Type ? or HELP for help 
C-Kermit >set file type binary undef 
C-Kermit> receive 

Alt-x (Escape back to the PC) 

MS-Kermit> set file type binary (PC uses binary mode) 

MS-Kermit >send schedule.bas (Send the file) 

(The file is transferred) 

MS-Kermit> connect (Let's go back and take a look) 

C-Kermit> dir /full schedule.bas 

Record format: Undefined, maximum 512 bytes 

C-Kermit> 

When C-Kermit is sending files from VMS, it determines text or binary mode automati¬ 
cally. Undefined-format files are sent correctly in binary mode. 
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The SET FILE TYPE IMAGE Command 

image mode is a kind of “super-binary” mode, in which raw disk blocks are transmitted. 
Use it when set file type binary doesn’t work. 

SET FILE TYPE IMAGE 

This command might better be called “binary, and this time I mean it!” When receiv¬ 
ing a file, this mode is equivalent to SET file type binary, except that it overrides the 
incoming Type attribute, if any. When sending a file, C-Kermit declares the file to be 
of type Binary in the Attribute packet and the blocks of the file are sent exactly as 
stored on disk, including any imbedded record-length fields and excluding any format¬ 
ting characters (such as line terminators) that would normally be supplied by RMS 
based on the file’s carriage-control attributes. Use set file type image to send files 
that have inappropriate or unusual file characteristics, such as a binary file that is 
stored in Stream LF format. Synonym: SET FILE TYPE BLOCK. 

Here’s an example. You have Lotus 1-2-3 on your PC and a version of Lotus 1-2-3 run¬ 
ning on your VMS system. You can send a PC Lotus spreadsheet file to VMS using set 
file type binary, and VMS Lotus reads it perfectly and without complaint. But when 
you try to send a VMS Lotus spreadsheet to the PC in the same way, PC Lotus can’t read 
it at all. Why not? Because VMS Lotus creates its spreadsheet files with carriage return 
carriage control, which makes C-Kermit send carriage return and line feed at the end of 
each record, resulting in an invalid format for PC Lotus. Use set file type image to cir¬ 
cumvent the problem: 

C-Kermit> set file type image (The important command) 

C-Kermit> send budqet.wks (Send the file) 

Alt-x (Escape back to the PC) 

MS-Kermit> receive (Receive the file) 

Another case where image mode is required is for files created by the VMS version of 
UNZIP, a dearchiving program, from VMS-resident ZIP files. Even when these are bi¬ 
nary files, the VMS ZIP program creates them with a “Stream_LF” record format, which 
C-Kermit treats as text unless you tell it otherwise. Use IMAGE for sending. BINARY 
works for receiving. 

VMS Labeled File Transfer 

We’ve seen how to coax VMS C-Kermit into transferring simple types of sequential files 
whose record size or format might not match C-Kermit’s defaults. But there still remain 
certain types of VMS files that defy all normal means of transfer—databases with indexed 
or relative organization, binary files with variable length records, and so on. Yes, you can 
transfer them, but when you bring them back to VMS, they are unusable. You can’t even 
transfer them directly from one VMS system to another. 
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To illustrate, let’s look at VMS object files. These are the files created by language com¬ 
pilers like Macro, Fortran, Pascal, and C, with names that end in . OBJ. For example, the 
command: 

$ macro ckvhex 

runs the Macro assembler on a source file called ckvhex .mar and produces an object file 
called ckvhex . OBJ. This object file is composed of variable length records, like a text 
file, but it is binary. You can’t use text mode to transfer it because the format of the 
record boundaries would be changed (carriage returns and linefeeds would be added), and 
you can’t use binary mode because the record boundaries would be lost altogether. Image 
mode doesn’t work either; the record boundaries are preserved but the record format infor¬ 
mation is lost from the directory entry. 

For situations like this, you need a way of sending not only the contents of the file, but its 
entire directory entry along with it. To do this, C-Kermit offers a fourth file type, called 
labeled. Labeled mode is used to preserve all the characteristics of the file after transfer, 
including its directory entry, internal record layout, RMS attributes, and so forth. It can be 
used directly between two VMS systems, in which case the file arrives and is stored with 
all its proper characteristics. 

Labeled mode transfers can also be done between VMS and any other kind of computer. 
A VMS file sent in labeled form to a non-VMS computer is unusable on the other com¬ 
puter. A labeled file sent to a VMS computer is recreated in its original form. 

Thus labeled mode is suitable both for VMS-to-VMS transfers and also for archiving 
VMS files on non-VMS systems. A labeled file can float from one computer to another 
until it finally finds its way back to a VMS system, where it is reincarnated. The com¬ 
mand to select labeled file transfers is: 

SET FILE TYPE LABELED 

When sending a file, C-Kermit sends an Attribute packet declaring the file to be of 
type Binary, then transmits all of the file’s characteristics in a specially coded heading 
as part of the file data. The file data itself is transmitted in Image mode. 

When C-Kermit’s FILE TYPE is LABELED, incoming files (which must be sent in binary 
mode) are treated as labeled if the Type Attribute says the file is binary, or if there is 
no Attribute packet at all. If C-Kermit’s file type is LABELED and the incoming at¬ 
tribute says the file is Text, C-Kermit rejects the file. Once having agreed to accept a 
file in labeled mode, VMS C-Kermit interprets the labeling information and attempts 
to use it to create the transferred file with all the same characteristics as the original, 
but with the version number set in the normal way. 
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Labeled files carry with them certain information that you will want to use in certain cir¬ 
cumstances and not in others. C-Kermit always includes this information when sending 
files in labeled format. Use the SET file label command to say what it should do with 
this information when receiving files: 

SET FILE LABEL NAME { OFF, ON } 

The labeled file contains the file’s full VMS file specification. The default is ON, 
meaning C-Kermit attempts to store the incoming file with its original name rather 
than the name that the other Kermit sent it with. Use set file label off to have it 
stored under the name it was sent with or any alternate name you may have given in 
the receive command. 

SET FILE LABEL PATH { OFF, ON } 

The labeled file also includes the file’s original disk and directory name. Normally 
C-Kermit stores an incoming labeled file in the current disk and directory. Use SET 
file label path ON to have C-Kermit attempt to store the file in the disk and direc¬ 
tory recorded within the labeled file itself. If file label path is OFF, the path is 
ignored. 

SET FILE LABEL ACL { OFF, ON } 

The labeled file includes the file’s original ACL (access control list), which contains 
information that would normally be useful only on the computer where the file 
originated. For example, VMS records access lists as binary numbers; restoring them 
on a different computer could wind up granting access to a random collection of users. 
Normally this data is ignored. SET FILE LABEL ACL ON to use it. 

This command also governs the RMS Journaling, RMS Statistics, DDIF, PATHWORKS, 
and other file ACL entries. Note that you can create ACL entries that you can’t see 
with dir/full unless you have VMS Security privilege (but you should still be able to 
view—but not modify—them with EDIT/ACL). Unprivileged users can not delete or 
modify incorrect ACL entries without deleting the file itself. Even when FILE LABEL 
ACL is ON, RMS Journaling is not enabled for a received file. 

SET FILE LABEL BACKUP { OFF, ON } 

This tells C-Kermit whether to preserve the file’s backup date, if one was included. 
OFF, which is the default, means that C-Kermit should ignore the backup date in the 
incoming labeled file and store the new file so it will be backed up. ON means to keep 
the labeled file’s backup date. 

SET FILE LABEL OWNER { OFF, ON } 

C-Kermit normally makes you the owner of the incoming file, set file label owner 
on if you want C-Kermit to preserve the file’s original owner (privileges required). 
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SET file TYPE LABELED can be used for all VMS-to-VMS transfers, as long as character 
set translation is not required and C-Kermit is running on both ends. It is the only mode 
of transmission that works for all kinds of VMS files. The set file type LABELED com¬ 
mand must be given to both VMS C-Kermit programs. 

To send a VMS file to another kind of computer (UNIX or MS-DOS, for example) for ar¬ 
chival, just give the SET file type labeled command to VMS C-Kermit before sending 
the file and make sure the other Kermit receives it in binary mode (it will do so automati¬ 
cally if it understands Attribute packets): 

C-Kermit> set file type labeled (Archival format) 

C-Kermit >send oofa.x (Send any kind of file) 

Alt-x (Escape back to PC) 

MS-Kermit>r (Receive the file) 

(The file is transferred) 

The resulting file contains all the necessary information to reconstruct it on a VMS sys¬ 
tem, no matter where it may travel in the meanwhile, as long as all its travels are in binary 
mode. When the time eventually comes for it to return to VMS, make sure to send it in bi¬ 
nary mode and to tell VMS C-Kermit to set file type labeled: 

C-Kermit> set file type labeled (Archival format) 

C-Kermit>r (Wait for the file) 

Alt-x (Escape back to PC) 

MS-Kermit> set file type binary (Use binary mode) 

MS-Kermit> send oofa.x (Send the file) 

(The file is transferred) 

You can easily identify a labeled file. Its first 20 characters are “KERMIT LABELED 
FILE:”. If one of these files should happen to find its way back to VMS without being 
decoded by Kermit, you can use a separate program distributed with C-Kermit, called 
CKVCVT, to decode it into its original form, just as C-Kermit would have done if it had 
received the file with SET file type labeled in effect: 

$ ckvcvt oofa.x 
Creating OOFA.X... 

... done. 

$ 

A labeled file stored on your VMS disk can even be mistakenly sent in labeled mode to 
another computer, and then brought back to VMS in this form: labels within labels! The 
ckvcvt program can be used to peel away excessive layers of labeling. 
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VMS C-Kermit Summary 

Important filenames: 

CKERMIT.INI 

The standard initialization file. It can be in your home (login) directory, or in a central 
shared location designated by the system-wide logical name CKERMITJNI. 

CKERMIT.SYS 

The system-wide customization file, used to augment or override the definitions made 
in the standard initialization file on a system-wide basis. VMS C-Kermit executes this 
file if it can be found in the directory denoted by the CKERMITJNI logical name. 

CKERMOD,INI 

Your personal customization file, used to augment or override the definitions made in 
the standard initialization file. Must be stored in your home directory. 

CKERMIT.KDD 

Your dialing directory, stored in your home directory. 

CKERMIT.KSD 

Your services directory, stored in your home directory. 

VMS C-Kermit has the unique ability to send a mixture of text and binary files in the 
same SEND or MSEND command. Any other Kermit program that supports Attribute pack¬ 
ets (see Table 1-1 on page 8) can accept such a mixture. Table IV-1 summarizes the inter¬ 
action of the various file types, the SEND and RECEIVE commands, and Attribute (A) pack¬ 
ets in VMS C-Kermit. 

Table IV-2 shows the types and record lengths to be used for transferring selected types of 
files between VMS C-Kermit and MS-DOS Kermit. The same settings should apply for 
other non-VMS Kermits, such as C-Kermit for UNIX or IBM mainframe Kermit. You 
can fill in the bottom of the table with any others that you encounter. 

Table IV-1 VMS Kermit SET FILE Commands 


SET FILE 
Command 

Send 

Receive 

RECORD-LENGTH 

Ignored 

Used for Binary and Image, but not Text, transfers 

TYPE TEXT 

Ignored 

Used unless overridden by A-packet 

TYPE BINARY 

Ignored 

Used unless overridden by A-packet 

TYPE IMAGE 

Used 

Used, overrides A-packet 

TYPE LABELED 

Used 

Used if A-packet does not say the file is text and if the file is in 
legitimate Labeled format. 
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Table IV-2 MS-DOS - VMS File Transfer 


Application 

VMS 

File 

Type 

MS-DOS 

File 

Type 

VMS 

Record 

Length 

Comments 

VMS EDT, EVE, etc. 

TEXT 

TEXT 

N/A 

Files created with text editors 

VMS FORTRAN 

TEXT 

TEXT 

N/A 

Fortran CC becomes CRLF 

DCL-created 

TEXT 

TEXT 

N/A 

VFC files become stream 

VMS LOTUS 

IMAGE 

BINARY 

512 

Can be used on VMS and PC 

PC LOTUS 

IMAGE 

BINARY 

512 

Can be used on VMS and PC 

VMS .EXE 

BINARY 

BINARY 

512 

Cannot be executed on PC 

VMS .OBJ 

LABELED 

BINARY 

N/A 

Object files 

VMS . OLB 

BINARY 

BINARY 

512 

Object libraries 

BACKUP Saveset 

BINARY 

BINARY 

>2048 

Use same record length as original 

PC .EXE 

BINARY 

BINARY 

512 

Cannot be executed on VMS 

SPSS Export 
Thoroughbred 

TEXT 

BINARY 

TEXT 

80 

Can be used on VMS and PC 

BASIC 

UNDEFINED 

BINARY 

N/A 

A closed, non-RMS application 

VMS .ZIP 

IMAGE 

BINARY 

512 

Can be used on both VMS and PC 

pc .zip 

BINARY 

BINARY 

512 

Can be used on both VMS and PC 

VMS Indexed 

LABELED 

BINARY 

N/A 


VMS Relative 

Add others: 

LABELED 

BINARY 

N/A 
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Appendix V 


OS/2 C-Kermit 


oooo 

This appendix supplies particulars about installing and using C-Kermit under 
OS/2. If you are not familiar with the fundamentals of OS/2, you can get an in¬ 
troduction by double-clicking on the “Start Here” icon on your OS/2 desktop. 

If C-Kermit is already installed on your OS/2 system, skip ahead to page 423. 

OS/2 C-Kermit runs on personal computers with an 80286 or higher processor with OS/2 
version 1.0 or higher (80386SX or higher is required by OS/2 2.0). OS/2 C-Kermit runs 
in character mode, either full-screen or in a window. It supports serial communication 
through your PC’s communication ports, either direct or dialed, as well as selected net¬ 
working methods. 

In addition to all the standard C-Kermit communication, file transfer, character-set trans¬ 
lation, and script programming features, OS/2 C-Kermit also includes its own built-in 
VT102 terminal emulator with extensions for color, key mapping, and screen rollback, 
fully described in this appendix. 

Installation 


The following installation procedure ensures that your OS/2 system is configured cor¬ 
rectly for C-Kermit and allows you to choose where to put the C-Kermit files on your hard 
disk, whether C-Kermit is to be a windowed or full screen application, and where its icon 
should go. 
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Preparing Your Serial Port 

If you will be using C-Kermit to communicate through a serial port, the OS/2 serial port 
device driver must be installed in your CONFIG.SYS file as follows. For version 1 of 
OS/2 on a PC with an ISA (PC/AT) or EISA bus, the following line is required: 

DEVICE=C:\OS2\COMO1.SYS 

For version 1 of OS/2 on a PC with a Micro Channel (PS/2) bus, the following line is 
needed: 

DEVICE=C:\OS2\COM02.SYS 


If you are running version 2 of OS/2 on a PC with either kind of bus, the following line 
must be present: 54 

DEVICE=C:\OS2\COM.SYS 

If you find that the appropriate line is missing from your CONFIG.SYS file, you can add it 
with a text editor such as OS/2’s E editor. If the driver is not available, unpack it from the 
distribution diskettes or use OS/2’s selective install feature (version 2 of OS/2 only). 
Then restart your OS/2 system by clicking on “Shut down” in the desktop menu and hold¬ 
ing down the Ctrl, Alt, and Del keys simultaneously after receiving the final shutdown 
message. 


You can use the OS/2 MODE command to inquire about the current settings of the serial 
port device driver: 


[C:\] mode coml 
BAUD = 1200 
DATABITS = 7 
TO = OFF 
IDSR = ON 
OCTS = ON 
RTS = ON 


PARITY = EVEN 
STOPBITS = 1 
XON = OFF 
ODSR = ON 
DTR = ON 
BUFFER = AUTO 


These parameters can be changed by using the OS/2 MODE command. When your OS/2 
serial port device driver is active, its default configuration requires the RS-232 DSR and 
CTS signals (see Appendix II) to be asserted by the communication device (modem or 
other computer). If your communication device does not assert CTS and DSR, a condition 
that can block successful communication, you can give the following MODE command to 
change the default behavior: 

[C:\1 mode coml: octs=off,odsr=off,idsr=off 


54 For IBM PS/2 Models 90 and 95, a special driver, comdma.sys, provides high-speed direct memory 
access. 


420 OS/2 C-Kermit / Appendix V 



You can get information about the MODE parameters by typing help mode at the OS/2 
CMD prompt or by clicking on the Information icon. Most settings are handled automati¬ 
cally by C-Kermit itself. Of those that are not, the recommended settings are: 

TO=ON 

Output timeout: None. 

BUFFER=ON 

To enable hardware character buffering for more efficient communication. This re¬ 
quires 16550 or similar buffered serial port hardware, such as found in IBM PS/2s. 


Installing the C-Kermit Files 

To install the C-Kermit files on your PC’s hard disk, follow these steps: 

1. In the Command Prompts window, select OS/2 Full Screen or OS/2 Window to get the 
CMD prompt, which normally is your current disk and directory enclosed in square 
brackets: 

[C:\] 

2. Create a directory called CKERMIT on your hard disk to hold the OS/2 Kermit files and 
then CD to it: 

[C:\I mkdir c:\ckermit 
[C:\j cd c:\ckermit 
[C:\CKERMIT] 

If you wish to install C-Kermit on a different disk, substitute its disk letter for c s. 

3. Insert the OS/2 C-Kermit diskette into your diskette drive and copy the files from it to 
the hard disk directory: 

[Cs\CKERMITi copy a:\*.* ■ 

The files include ckermit . exe (the executable OS/2 C-Kermit program), 
ckermit . ico (the C-Kermit icon), ckermit . ini (the standard initialization file), 
ckermod.ini (a sample customization file), and CKERMIT.CMD (a sample REXX file 
for starting C-Kermit). As distributed, CKERMIT. CMD looks like this: 

/* C-Kermit Startup File */ 

"@echo off" /* Don't echo these commands */ 

"echo Executing CKERMIT.CMD..." 

"chcp 850” /* Use Code Page 850 */ 

"mode co80,25" /* Screen size 80 by 25 lines */ 

"mode coml buffer=on,to=on" /* Hardware buffering, no timeout */ 
"ckermit.exe %1 %2 %3 %4 %5 %6 %7 %8 %9" /* Start C-Kermit */ 

The doublequotes are required to distinguish OS/2 commands from REXX commands. 
The % 1.. %9 variables pass any C-Kermit command line arguments (up to nine of 
them) through the command file to C-Kermit itself (see Chapter 14). 
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4. Use the OS/2 editor, E, to make any desired changes to the ckermod . ini and 
CKERMIT.CMD files: 

rC:\CKERMIT1 e ckermod.ini 
fC:\CKERMIT1 e ckermit.cmd 

For example, if you want to run C-Kermit in a 43-line window, change "mode 
co80,25" to "mode co80,43" in CKERMIT.CMD. 

5. Exit from the OS/2 window back to the desktop: 
f C:\CKERMIT1 exit 

Now create a desktop object that you can double-click on to start C-Kermit. In OS/2 ver¬ 
sion 1, make an entry in the Desktop Manager Group Window. In OS/2 version 2, make a 
new Program Reference Object: 

1. Double-click on the Templates folder on your desktop. 

2. Use the mouse to drag the program template to the desired location on your desktop. 
The settings notebook of the new object should pop up automatically. 

3. Fill in the full pathname of the CKERMIT. CMD file, for example: 

C s\CKERMIT\CKERMIT.CMD 

4. Fill in any desired (optional) command-line arguments for C-Kermit, for example: 

-1 com2 -b 2400 -p e 

to always start C-Kermit on COM2 at 2400 bps and even parity (see Chapter 14 for a 
description of C-Kermit’s command-line options). 

5. Set C-Kermit’s working directory to the directory where C-Kermit and its initializa¬ 
tion file are stored, so C-Kermit can find its initialization file. If you don’t want this 
directory to be C-Kermit’s default directory for file transfer, you can also put a CD 
command in the CKERMOD.INI file. 

6. By default, C-Kermit will be installed as a windowed application, but you can also 
choose to run it as a fullscreen application: 

• In a window, text is simulated by graphics operations (causing C-Kermit to run 
more slowly than it would in fullscreen mode), and the window is restricted to 80 
characters in width. But when you run C-Kermit in an OS/2 window, you can cut 
and paste, move around among different windows easily, and you have access to 
the title-bar pop-up menu for changing fonts, closing C-Kermit in case of disaster, 
and so on. 
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• If you choose to make C-Kermit a fullscreen application, the screen is updated 
more quickly and it can contain as many characters per line as your display adapter 
permits, such as 132 columns on the XGA. But you will not have access to the 
pop-up menu and you won’t be able to cut and paste. 

• In both fullscreen and windowed mode, C-Kermit can use more than 25 lines if 
you execute a mode command like MODE 0080,43 before starting C-Kermit. 

To choose fullscreen operation, click on the Session tab of the settings notebook and 
then click on “OS/2 full screen.” 

7. By default, double-clicking on the C-Kermit icon when C-Kermit is already active 
continues the active copy of C-Kermit. If you want to run multiple copies of 
C-Kermit simultaneously, click on the Window tab of the settings notebook and 
then select “Create new window.” 

8. Finally, click on the General tab of the settings notebook. Fill in the title, 

“C-Kermit,” uncheck the Template item (if it is checked), and then close the settings 
window. 

Your installation of C-Kermit is now complete. The C-Kermit icon should be available on 
the OS/2 desktop or in the folder that you chose in step 2. 

Using OS/2 C-Kermit _ 

Once C-Kermit is installed, you can start it by clicking on its icon or you can run it from 
the OS/2 CMD prompt. 

Starting C-Kermit from Its Icon 

Double-click on the C-Kermit icon. C-Kermit starts, occupying the full screen or a win¬ 
dow, depending on the setting you chose in step 6. The C-Kermit initialization file issues 
a greeting message, such as: 

Executing C s\CKERMIT\CKERMIT.INI... 

If you don’t see this message, the CKERMIT.INI file is not in the same directory as 
CKERMIT.EXE or C-Kermit isn’t configured to use the CKERMIT directory as its startup 
directory. 

At this point you should see C-Kermit’s herald and prompt: 

C-Kermit 5A(188), 23 Nov 92, OS/2 2.00 

Type ? or HELP for help 

C-Kermit> 
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If you have chosen windowed operation, you might notice the first time you start 
C-Kermit that its window is not full size. This is normal for VGA and lower-resolution 
video adapters. To bring C-Kermit’s window to the desired size, hold down the Shift key 
and click on the “maximize” (square) box at the right end of C-Kermit’s title bar. This 
grows the C-Kermit window to the size specified in your MODE command and makes it 
C-Kermit’s permanent startup window size. 

Starting C-Kermit from the CMD Prompt 

You can also start C-Kermit from the OS/2 command prompt by typing its name followed 
by any desired command line options, for example: 

[C;\] ckermit -1 com3 -b 19200 -p m 

All the settings in the Program Reference Object are bypassed, and C-Kermit fills the cur¬ 
rent OS/2 window. If you have both a ckermit , EXE and ckermit . cmd file in the same 
directory, OS/2 runs the .EXE file if you don’t specify a filetype. To start C-Kermit from 
the OS/2 command file, include the . cmd filetype: 

[Ci\l ckermit.cmd -1 com3 -b 19200 -p m 

If C-Kermit is not in your current directory or in any directory in your OS/2 PATH, OS/2 
won’t find it. You can change your OS/2 PATH by altering the SET PATH command in the 
CONFIG.SYS file, or you can invoke C-Kermit by its complete pathname: 

[C:\1 c:\ckermit\ckermit.cmd 

OS/2 C-Kermit Command Procedures 

C-Kermit command files can be executed directly without having to start C-Kermit first if 
they include an extproc command as the first line in the file, specifying the full path¬ 
name of the C-Kermit program, for example: 
extproc c:\ckermit\ckermit.exe 

EXTPROC is an OS/2 command for running external procedures. It runs the program 
whose name is given, and feeds the remaining lines in the file to that program. To 
C-Kermit, EXTPROC is a synonym for COMMENT. 

Create the command file with a text editor like E, using a file type of . cmd, and save it as 
an OS/2 command procedure. You can run it from the OS/2 command line by typing its 
name. You can also create a desktop program object for it, just as you did for the 
ckermit.cmd file when you installed it, copying the C-Kermit icon or creating a new 
icon of your own, and then double-clicking on the icon to run it. 

For example, suppose there are two different connections you normally make, one of them 
a 2400-bps dialed connection on COM1, and the other a 38400-bps direct connection on 
COM2. Create a separate command procedure for each connection: 
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extproc c:\ckermit\ckermit.exe 

set modem hayes 

set line coml 

set speed 2400 

dial 7654321 

if success connect 

else exit 1 

and: 

extproc c:\ckermit\ckermit.exe 

set line com2 

set speed 38400 

set flow rts/cts 

connect 


Hayes modem dialing 
on communication port 1 
at 2400 bps 
Dial the number 
CONNECT if it answered 
otherwise quit 


Direct connection through COM2 
at 38400 bits per seconds 
using hardware flow control 
Begin terminal emulation 


Call these files, say, dialup.cmd and direct.cmd, and run the appropriate one when¬ 
ever you want to make a connection. You can even run them both at the same time. 


Serial Communications 

OS/2 version 1 supports the COM1 and COM2 serial devices on all PC models, plus 
COM3 on Micro Channel PS/2 systems. OS/2 version 2 supports COM1 through COM4. 
C-Kermit can use any communication speed supported by the communication port driver, 
up to 57600 bps on most systems, and possibly 76800 and 115200 bps. But the fact that 
the communication driver allows high speeds does not necessarily mean that C-Kermit, or 
any other application, or the driver itself, can keep up with high-speed input. 

Communication Port, Speed, and Modem Signals 

When C-Kermit starts, its communication device is set to COM1, serial port number 1, 
and the communication speed is set to the current speed of that device. You can select dif¬ 
ferent serial ports with the set line command and change their speeds with set speed. 

The port’s DTR and RTS signals both go ON when C-Kermit opens it and they go OFF 
when the port is closed or when C-Kermit terminates. OS/2 C-Kermit treats the carrier 
signal according to your most recent SET carrier command, AUTO by default. Unless 
you SET carrier off, loss of carrier during CONNECT mode causes C-Kermit to return to 
its prompt automatically. 

Parity, Data Bits, and Stop Bits 

C-Kermit always sets the port driver to 8 data bits and no parity, then handles parity inter¬ 
nally according to your SET PARITY setting. When C-Kermit’s parity is NONE, 8 data bits 
are used. When it is even, odd, mark, or space, C-Kermit uses 7 data bits and handles 
the parity bit itself. These operations are internal to C-Kermit; the port driver’s parity 
handling is not used. You can change the number of stop bits with the OS/2 mode com¬ 
mand before starting Kermit if necessary. 
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Flow Control 

OS/2 C-Kermit supports both Xon/Xoff and RTS/CTS flow control. The flow-control 
method is specified by C-Kermit’s SET FLOW command. The default is KEEP, meaning the 
serial port device driver is to use whatever flow-control method it was already configured 
with, for example by the OS/2 MODE command. 

Use the C-Kermit command set flow xon/xoff to select software flow control, or set 
flow RTS/CTS if you want to use RTS/CTS hardware flow control, set flow none turns 
off flow control altogether. Xon/Xoff (software) flow control is available on both serial 
and network connections. When you have selected this type of flow control, the OS/2 
serial communication driver does not allow the transmission of Ctrl-Q and Ctrl-S as data 
characters. RTS/CTS (hardware) flow control works only on serial connections, and then 
only when the device to which your serial port is immediately connected supports it and is 
configured to use it. 

You should use RTS/CTS hardware flow control whenever your connection permits. 
Hardware flow control is far more reliable and responsive than software flow control, and 
it also permits the transmission of Ctrl-S and Ctrl-Q characters as ordinary data. 

Network Connections 

OS/2 C-Kermit supports DECnet LAT connections if you have installed DEC 
PATHWORKS on your PC. Use C-Kermif s SHOW NETWORK command to check whether 
any other networks are supported, such as IBM TCP/IP or Microsoft LAN Manager. Use 
SET NETWORK to select any of the available network types, and SET HOST to select a host 
on the given network, as described in Chapter 3. 

Terminal Emulation 

When you first issue the CONNECT command, you get a blank screen with a blinking cur¬ 
sor in the top left comer and a status line on the bottom. This indicates that C-Kermit is 
ready to communicate. The CONNECT command fails if the communication device is not 
properly conditioned, for example if you CONNECT to a modem before dialing without 
having first issued the SET CARRIER OFF command. 

The screen dimensions are determined by your display adapter and your most recent 
mode command in the current window (see the Installation section of this appendix). The 
cursor shape, as well as the foreground, background, and status-line colors are chosen by 
default, but special SET TERMINAL commands (listed on p. 432 in this appendix) allow you 
to change them. 

In CONNECT mode, OS/2 C-Kermit emulates the Digital Equipment Corporation VT102 
and VT52 terminals with extensions for color, key redefinition, and screen rollback. The 
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control codes and escape sequences recognized by the terminal emulator are listed in 
Tables V-4 through V-10, beginning on page 435 at the end of this appendix. 

Keyboard input is obtained through the OS/2 KBD subsystem, and screen output is 
through the VIO subsystem. It is therefore not possible to redirect terminal I/O. 

Terminal Character Sets 

The VT102 terminal, and therefore OS/2 C-Kermit’s connect command, does not sup¬ 
port host-controlled ISO 2022 character-set designation and invocation except for switch¬ 
ing between ASCII and the DEC Special Graphics character set. Use the set terminal 
character-set command to select your terminal emulation character set, and set ter¬ 
minal locking-shift to enable the use of 8-bit character sets in a 7-bit communication 
environment where the Shift-In/Shift-Out mechanism is supported. Both of these com¬ 
mands are explained in Chapter 9. 

Your file character-set, and therefore also the local end of your terminal character-set, is 
automatically set to be your current PC code page, for example, CP437 or CP850. Thus 
you only need to specify the remote character set in your set terminal character-set 
command. 

The Status Line and Alt-Key Commands 

The bottom (normally 25th) line on the screen is used as a status line, giving the name of 
the communication port, the current speed, how to return to the prompt, and how to get 
help. The default coNNECT-mode escape character is Ctrl-] (Control-Rightbracket), but 
you can change it with the SET ESCAPE command. You can also use Alt-key combinations 
to accomplish many of the CONNECT-mode escape functions, for example Alt-X to escape 
back to the C-Kermit prompt. Typing Alt-? or the escape character followed by a question 
mark displays a pop-up help window showing the available options. These are also listed 
in Table V-l on the next page. 

When you escape back to the prompt, the screen is restored to its state when the connect 
command was issued. A subsequent CONNECT command redisplays the previous terminal 
emulation screen. 

Cutting and Pasting 

Cut-and-paste (mouse editing) is available when C-Kermit is running in a window. You 
can copy text from any text window (including C-Kermit’s own window) and paste it into 
the C-Kermit window at the current cursor location. If C-Kermit is at its command 
prompt, the text is interpreted as a command. If C-Kermit is in connect mode, the 
pasted text is transmitted out the communication port just as if you had typed the text on 
the keyboard. You can also copy text from the C-Kermit command or terminal window 
and paste it into any other text window, or even into the same window, for example to 
reissue an earlier command. 
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The Keyboard 

C-Kermit’s normal coNNECT-mode escape commands (Chapter 4) are available in 
CONNECT mode. In addition, OS/2 C-Kermit’s terminal emulator supports several 
categories of special keys including Alt-key equivalents for CONNECT-mode escapes, 
screen rollback keys, a no-scroll key, keys for screen printing, as well as VT-terminal 
function key equivalents. These are listed in Table V-l and described in detail on the fol¬ 
lowing pages. 


Table V-l Special PC Keys in connect Mode 


IBM 

Key 

Key 

Code 

Action 

Alt = 

\387 

Clears screen and resets terminal emulator 

Alt ? (or Alt-/) 

\309 

Displays help message 

Alt X (or Alt-x) 

\301 

Returns to the C-Kermit prompt 

Alt H (or Alt-h) 

\291 

Hangs up and returns to the prompt 

Alt Q (or Alt-q) 

\272 

Exits connect mode, hangs up, and exits C-Kermit 

Alt B (or Alt-b) 

\304 

Sends a BREAK signal 

Alt L (or Alt-1) 

\294 

Sends a Long BREAK signal 

Home 

\327 

Rolls screen up (text down) to beginning of rollback buffer 

Gray Home 

\583 

Same as Home 

End 

\335 

Rolls screen down (text up) to current screen 

Gray End 

\591 

Same as End 

PgUp 

\329 

Rolls screen up (back, earlier) one screen 

Gray Page Up 

\585 

Same as PgUp 

PgDn 

\337 

Rolls screen down (forward, later) one screen 

Gray Page Down 

\593 

Same as PgDn 

Ctrl-PgUp 

\388 

Rolls screen up one line 

Ctrl-Gray-Page-Up 

\644 

Same as Ctrl-PgUp 

Ctrl-PgDn 

\374 

Rolls screen down one line 

Ctrl-Gray-Page-Down 

\630 

Same as Ctrl-PgDn 

Scroll Lock 

\767 

No Scroll (freezes screen) 

Print Screen 


Prints current screen (handled by OS/2) 
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The Scroll Lock Key 

The PC’s Scroll Lock key (equivalent to the VT102 No Scroll key) freezes the screen 
during CONNECT mode. It is typically used when displaying a long file to prevent infor¬ 
mation from scrolling off the top of the screen. The Control-S and Control-Q (Xon/Xoff) 
keys should not be used for this purpose if FLOW-CONTROL is set to XON/XOFF, because 
they interfere with the operation of the communication device driver’s flow control. 

When the Scroll Lock key is pressed, the current flow-control mechanism (Xon/Xoff or 
RTS/CTS) is used to stop the flow of characters from the other computer, for example by 
sending an XOFF character (Ctrl-S) or by turning off the RTS signal. Obviously, the 
other computer or communication device must be configured to cooperate. When Scroll 
Lock is pressed again, the flow of characters resumes. All other keys are ignored when 
the screen is frozen. The status line indicates when Scroll Lock is in effect. 

The Arrow Keys and the Numeric Keypad 

Table V-2 shows the PC arrow keys, their key codes, and the escape sequences they send. 
These sequences depend on whether the arrow keys are in application mode or cursor 
mode. The mode is set by control sequences from the host (SM parameter DECCKM, see 
Table V-8 on page 439), or by you with the SET TERMINAL ARROW-KEYS command. Table 
V-2 applies to the arrow keys on the numeric keypad if Num Lock is Off, and also (on en¬ 
hanced PC keyboards) to the gray cursor (arrow) keypad. 

Table V-3 on the next page shows the DEC VT102 and VT52 keyboard numeric keypad 
keys, the corresponding PC keyboard assignments (which are not on the PC’s numeric 
keypad), the SET key codes for the PC keys, and the characters or escape sequences sent 
by these keys. 

The DEC keypad can be in either numeric mode or application mode. The keypad mode 
is set by control sequences from the host (SM parameter DECNKM, see Table V-8), or 
with C-Kermit’s SET TERMINAL KEYPAD-MODE command. Kermit’s initial keypad mode 
is numeric. The Alt-key combinations use the number keys along the top row of the 
keyboard, not the ones on the numeric keypad. 


Table V-2 The Arrow Keys 


Key 

Keypad 

Code 

Gray Key 
Code 

VT102 

Cursor Mode 

VT102 

Application Mode 

VT52 

All Modes 

Up-Arrow 

\328 

\584 

ESC 

[ 

A 

ESC 0 A 

ESC A 

Down-Arrow 

\336 

\592 

ESC 

[ 

B 

ESC 0 B 

ESC B 

Right-Arrow 

\333 

\589 

ESC 

[ 

C 

ESC 0 C 

ESC C 

Left-Arrow 

\331 

\587 

ESC 

[ 

D 

ESC 0 D 

ESC D 
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Table V-3 The Numeric Keypad 


DEC 

Key 

IBM 

Key 

Code 

VT102 

Numeric 

Mode 

VT102 

Application 

Mode 

VT52 

Numeric 

Mode 

VT52 

Application 

Mode 

PFl/Blue 

FI 

\315 

ESC 

0 

P 

ESC 

0 

p 

ESC P 

ESC 

P 


PF2/Red 

F2 

\316 

ESC 

0 

Q 

ESC 

0 

Q 

ESC Q 

ESC 

Q 


PF3/Gray 

F3 

\317 

ESC 

0 

R 

ESC 

0 

R 

ESC R 

ESC 

R 


PF4 

F4 

\318 

ESC 

0 

S 

ESC 

0 

S 

ESC S 

ESC 

S 


0 

Alt-0 

\385 

0 



ESC 

0 

P 

0 

ESC 

? 

P 

1 

Alt-1 

\376 

1 



ESC 

0 

q 

1 

ESC 

? 

q 

2 

Alt-2 

\377 

2 



ESC 

0 

r 

2 

ESC 

? 

r 

3 

Alt-3 

\378 

3 



ESC 

0 

S 

3 

ESC 

? 

s 

4 

Alt-4 

\379 

4 



ESC 

0 

t 

4 

ESC 

7 

t 

5 

Alt-5 

\380 

5 



ESC 

0 

U 

5 

ESC 

? 

u 

6 

Alt-6 

\381 

6 



ESC 

0 

V 

6 

ESC 

? 

V 

7 

Alt-7 

\382 

7 



ESC 

0 

w 

7 

ESC 

? 

w 

8 

Alt-8 

\383 

8 



ESC 

0 

X 

8 

ESC 

? 

X 

9 

Alt-9 

\384 

9 



ESC 

0 

y 

9 

ESC 

? 

y 

comma (,) 

3 

o 

■1 

oo 

\321or\322 

r 



ESC 

0 

X 

f 

ESC 

7 

l 

minus (-) 

F5 or F6 

\319 or \320 

- 



ESC 

0 

m 

- 

ESC 

7 

m 

period (.) 

F9 

\323 

• 



ESC 

0 

n 

• 

ESC 

7 

n 

Enter 

F10 

\324 

CR, 

CRLF 

ESC 

0 

M 

CR,CRLF 

ESC 

7 

M 


Screen Rollback 

Information that scrolls off the top of the screen is kept in a rollback buffer that can be 
viewed by pressing the numeric keypad PgUp key or the gray keypad Page Up key. The 
rollback buffer holds 10 24-line screens of data, and you can use the PgUp, Page Up, 
PgDn, and Page Down keys to range freely through it. PgUp goes to a previous screen, 
and Ctrl-PgUp scrolls the screen back one line. Similarly, PgDn goes to a newer screen, 
and Ctrl-PgDn scrolls the screen forward one line. 

The End key returns immediately to the current (bottom, latest) screen, and the Home key 
goes immediately to the top of the rollback buffer. If any other key is pressed while the 
rollback buffer is visible, the current screen contents are redisplayed and the keystroke is 
sent out the communication device. 
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Key Redefinition 

OS/2 C-Kermit’s SET KEY command provides the normal keyboard mapping for keys that 
are associated with 7- or 8-bit characters; that is, the keys that have codes ranging from 0 
to 255 as shown by the show key command. A particular key can be mapped to itself, to 
another key (a single key stroke), or to a sequence of key strokes (a character string). 

OS/2 C-Kermit also supports the special PC keys, such as cursor and function keys, in 
various combinations with Shift, Control and Alt. These have codes ranging from 256 to 
767 and can also be displayed with SHOW KEY. 

The PC keys listed in Tables V-l through V-3 have special functions associated with 
them. These include the arrow (cursor) keys, FI through F4, Alt-0 through Alt-9, Scroll 
Lock, as well as keypad comma, minus, period, and Enter. In addition, the PgUp (Page 
Up), PgDn (Page Down), and End keys are used to control screen rollback; Print Screen is 
used by OS/2 for printing, and various Alt-key combinations are used as CONNECT-mode 
escape equivalents. 

If you use SET key to assign anything other than “Self, no translation” to these special 
keys, their special function is lost. For example: 

C-Kermit> set key \787 hello 

assigns the string “hello” to the Scroll Lock key and, since the no-scroll function is as¬ 
sociated with only one key, this disables the no-scroll feature entirely. 

If you assign the code of a special key to another key, it is the same as copying the func¬ 
tion of the special key to the second key. For example: 

C-Kermit >set key \315 \787 

assigns the no-scroll function to the FI key as well as to the Scroll Lock key. Note: you 
can’t actually move a function, only copy it or disable it. 

Printing 

If you have a printer driver installed, you can use the Print Screen key to copy the current 
C-Kermit screen (command or terminal) to your printer. 

C-Kermit also supports host-controlled “transparent printing.” If the host sends the Enter 
Transparent Print (see Table V-6 on page 437) sequence to Kermit, subsequent text is sent 
transparently (that is, without interpretation of escape sequences or translation of charac¬ 
ters) to your printer instead of the screen, until C-Kermit receives the Exit Transparent 
Print sequence. 

You may also have your connect session copied to the printer by specifying the generic 
OS/2 printer device, prn, as the destination of a log session command. 
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Terminal Emulation Settings 

OS/2 C-Kermit includes several special set terminal commands to control its built-in 
terminal emulator during CONNECT mode: 

SET TERMINAL ARROW-KEYS { APPLICATION, CURSOR } 

Explicitly sets the arrow key mode. The default mode is CURSOR. Use this command 
to change the arrow key mode if you are having trouble making the arrow keys work 
with a host application. 

SET TERMINAL CHARACTER-SET remote-cset [ local-cset ] 

Use this command to specify the remote character set for terminal emulation. The lo¬ 
cal character set is, by default, your current PC code page, which OS/2 C-Kermit 
senses automatically. So, for example, to prepare OS/2 C-Kermit for a terminal ses¬ 
sion with a computer that uses the Latin-1 character set: 

rC:\j chcp 850 (Use Code Page 850) 

[ C:\1 ckermit (Start C-Kermit) 

C-Kermit> set term character-set latinl 

SET TERMINAL COLOR text-type foreground-color background-color 

This command lets you set the foreground and background colors for various types of 
text during CONNECT mode. The color choices include: BLACK, BLUE, BROWN, CYAN, 
DGRAY (dark gray), GREEN, LBLUE (light blue), LCYAN (light cyan), LGREEN (light 
green), LRED (light red), MAGENTA, RED, WHITE, and YELLOW. The text types are: 
help (the pop-up cONNECT-mode help screens), normal (the normal terminal 
screen), reverse (the reverse video terminal screen), STATUS (the status line), and 
UNDERLINED (underlined text on the terminal screen is simulated by color due to 
restrictions in the PC video adapter design). 

SET TERMINAL CURSOR { FULL, HALF, UNDERLINE } 

Selects the cursor shape for terminal emulation, full is a large block cursor, half is 
a half-height block cursor, and underline is an underline-shaped cursor. 

SET TERMINAL KEYPAD-MODE { APPLICATION, NUMERIC } 

Explicitly sets the keypad mode; the default is NUMERIC. Use this command if you are 
having trouble making the keypad keys work with host applications. 

SET TERMINAL TYPE { VT102, VT52 } 

Chooses the desired terminal emulation. Unless you say otherwise, C-Kermit emu¬ 
lates the VT102 terminal. 

SET TERMINAL WRAP { ON, OFF } 

Turns line wrap on and off. Normally ON: the emulator automatically wraps long lines 
onto new lines. OFF means long lines are cut off at the screen edge. 
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File Names and Formats 

The OS/2 directory separator is the backslash (\) character, the same as in MS-DOS. But 
backslash is also used by C-Kermit’s command interpreter to quote special characters, in¬ 
troduce variables, and so on. Therefore, when including OS/2 (or MS-DOS) file speci¬ 
fications in a C-Kermit command, you have to type two copies of each backslash, for 
example: 

C-Kermit> send c:WfilesWckermit.ini 
C-Kermit> cd a:\\binaries 

For convenience, C-Kermit also accepts forward slash (/) as a directory separator in OS/2 
file and directory specifications. When you use forward slash rather than backslash, you 
don’t have to double the directory separators: 

C-Kermit >send c:/ckermit/ckermit.ini 
C-Kermit>cd a:/binaries 


Wildcards 

OS/2 allows a group of files to be specified in a single file specification by including the 
wildcard characters, asterisk (*) and question mark (?). Asterisk matches any string of 
characters from the current position to the end of the field, including no characters at all; 
question mark matches any single character. 


The question mark must be quoted by backslash in C-Kermit commands to override its 
normal use for requesting a file menu. Example: 


C-Kermit> send *.txt (All " .txt" files) 
C-Kermit> send x*.? Filename, one of the following: 
xray.l xray.2 xray.3 xray.4 

xray.5 xray.6 xray.7 xray.10 

xray.31 xray.lll xray.112 

C-Kermit>send x*.\? ("xray " files , 1 thru 7) 


File Formats 

OS/2 systems store files as streams of 8-bit bytes, with no particular distinction among 
text, program code, and binary files. Plain text files consist of lines of text separated by 
carriage-retum-linefeed sequences, with no font or rendition information (boldface, italic, 
point size) imbedded among the text characters. Most other types of files (word processor 
documents, spreadsheets, databases, application-specific data, and so on) should be con¬ 
sidered binary. 

By longstanding convention, observed by most OS/2 and MS-DOS (and CP/M) applica¬ 
tion software, the end of a text file is marked by the first Ctrl-Z character it contains, even 
if the Ctrl-Z occurs before the true end of the file. The end of a binary file is the final byte 
in the file, determined by the size recorded in the file’s directory entry. 
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File Transfer 

OS/2 C-Kermit supports all of C-Kermit’s file transfer features, including text 
character-set translation for many character sets, and the full complement of file-transfer 
display styles, including fullscreen, which is handled by OS/2’s built-in ANSI console 
driver. If your connection supports it, RTS/CTS (hardware) flow control is recommended 
for file transfer through a high-speed serial communication device. 

Sending Files 

In the SEND and msend commands, OS/2 C-Kermit understands both FAT (short 
MS-DOS style) file names as well as HPFS (long OS/2) file names, and can work with 
any mixture of FAT and HPFS disk volumes. The same is true of OS/2 C-Kermit in serv¬ 
er mode when it receives a get command. 

When sending files in text mode, OS/2 C-Kermit treats the first Control-Z in the file as the 
end of the file, in accordance with MS-DOS and OS/2 convention. Neither the Ctrl-Z nor 
any characters that follow it are transmitted to the other computer. 

When sending files in binary mode, no conversions or translations are performed, Ctrl-Z 
characters are treated as ordinary data, and the end of the file is determined by its length as 
shown by the directory command. 

Receiving Files 

When receiving files, C-Kermit takes advantage of long HPFS and NFS file names if 
these files are received onto an HPFS or NFS disk. When receiving onto a FAT file sys¬ 
tem, the name is automatically truncated if it is too long. Received files are always stored 
in their entirety, regardless of the transfer mode and the presence of Ctrl-Z characters in 
the data. 

If a file arrives that has the same name as an existing file, OS/2 C-Kermit might rename 
the incoming file or the existing file, depending on your FILE COLLISION setting. When 
renaming files, a number is appended to the end of the name before the period. For ex¬ 
ample, OOFA.TXT would be renamed to OOFAOOOl.TXT. If another OOFA.TXT arrives, 
an OOFA0002.TXT is created, and so forth. With HPFS, a suffix is added after the 
filetype: oofa.txt.-1-, oofa.txt.-2-, and so on. 

File Transfer Character Sets 

OS/2 C-Kermit’s default file character-set is your current PC code page, normally CP437 
or CP850. So when transferring international text, you normally need only give the SET 
transfer character-set command, for example: 

C-Kermit> set transfer character-set latinl 
Or you can put this command in your CKERMOD. INI file. 
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VT102 Escape Sequences 

The tables in this section list the control characters and escape sequences recognized by 
OS/2 C-Kermit’s VT102 terminal emulator. See the DEC VT102 manual [25] for further 
details. Control characters and escape sequences are recognized only in their 7-bit forms. 
Host-controlled character-set designation and invocation is not supported, except for the 
DEC Special and Line Drawing character set, but you can choose character sets yourself 
with C-Kermit’s SET terminal character-set command. The VT102 emulator also in¬ 
cludes a VT52 submode, whose escape sequences are shown in Table V-10 on page 440. 

Table V-4 shows the terminal emulator’s response to control characters received from the 
communication device; control codes not shown are ignored. 


Table V-4 Control Characters 


Name 

Dec 

Hex 

Keyboard 

Description 

NUL 

000 

OOh 

A @ 

Ignored except during transparent printing 

ENQ 

005 

05h 

A E 

Sends answerback sequence “OS/2 C-Kermit” 

BEL 

007 

07h 

A G 

Sounds DEC-style beep or flashes screen 

BS 

008 

08h 

A H 

Backspace, moves cursor left one character 

HT 

009 

09h 

"I, Tab 

Horizontal tab, moves cursor to next tabstop 

LF 

010 

Oah 

A J 

Linefeed, moves cursor down one line 

VT 

011 

Obh 


Vertical Tab, treated as a linefeed 

FF 

012 

Och 

A L 

Formfeed, treated as a linefeed 

CR 

013 

Odh 

~M, Enter 

Carriage return, moves cursor to column 1 

SO/LSI 

014 

Oeh 


Locking shift 1, selects G1 character set 

SI/LSO 

015 

Ofh 

'O 

Locking shift 0, selects GO character set 

DC1 

017 

llh 

A Q 

XON flow control, resumes communication 

DC3 

019 

13h 


XOFF flow control, suspends communication 

CAN 

024 

18h 

"X 

Cancels escape or control sequence in progress 

SUB 

026 

lah 

"Z 

Treated the same as CAN 

ESC 

027 

lbh 

A [, Esc 

Starts an escape sequence, cancels any others 

DEL 

127 

7fh 

Del 

Ignored except during transparent printing 


VT102 Escape Sequences 
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Table V-5 lists the escape sequences recognized by the VT102 terminal emulator when 
received from the communication device, or when typed at the keyboard when TERMINAL 
ECHO is ON. The mnemonic is the DEC name for the escape sequence. 


Table V-5 VT102 Escape Sequences 


Escape 

Sequence 

Mnemonic 

Description of Action 

ESC 7 

DECSC 

Saves cursor position, attributes, GL and GR character sets, wrap 



flag, origin mode (DECOM) 

ESC 8 

DECRC 

Restores cursor and other information from DECSC 

ESC # 3 

DECDHL 

Double-height and -width line, top half (simulated) 

ESC # 4 

DECDHL 

Double-height and -width line, bottom half (simulated) 

ESC # 5 

DECSWL 

Single-height and -width line 

ESC # 6 

DECDWL 

Double-width single-height line (simulated) 

ESC # 8 

DECALN 

Screen alignment test, fills screen with E’s 

ESC ( B 

SCS 

Designates ASCII to GO 

ESC ( 0 

SCS 

Designates line-drawing characters to GO 

ESC < 


Exits VT52 mode to ANSI (VT102) mode 

ESC = 

DECKPAM 

Enters numeric keypad application mode 

ESC > 

DECKNPNM 

Enters numeric keypad numeric mode 

ESC D 

IND 

Index; cursor down one line, can scroll 

ESC E 

NEL 

New Line; cursor to start of line below, can scroll 

ESC H 

HTS 

Sets horizontal tab stop at current position 

ESC M 

RI 

Reverse Index; cursor up one line, can scroll 

ESC Z 

DECID 

Identifies terminal. Response is esc [ ? 6 c in VT102 mode. 



esc / z in VT52 mode. 

ESC [ 

CSI 

Control Sequence Introducer; see Table V-6 

ESC C 

RIS 

Hard reset; resets terminal to initial state 
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Table V-6 shows the control sequences recognized by VT102 emulator. 


Table V-6 VT102 Control Sequences 

Control Sequence Mnemonic 

ESC [ Pn A CUU 

ESC [ Pn B CUD 

ESC [ Pn C CUF 

ESC [ Pn D CUB 

ESC [ Pr; Pc H CUP 

ESC [ Ps J ED 

ESC [ 0 J ED 

ESC [ 1 J ED 

ESC [ 2 J ED 


ESC [ Ps K EL 

ESC [OK EL 

ESC [IK EL 

ESC [ 2 K EL 

ESC [ Pn L IL 

ESC [ Pn M DL 

ESC [ Pn P DCH 

ESC [ C DA 


ESC [ Pr; Pc f HVP 

ESC [ Ps g TBC 

ESC [ 4 i MC 


Description of Action 

Cursor up Pn lines, does not scroll 

Cursor down Pn lines, does not scroll 

Cursor forward, stays on same line 

Cursor backward, stays on same line 

Sets cursor to row Pr, column Pc (same as 
HVP) 

Erase-in-display, Ps = 0,1, or 2: 

Erases from cursor to end of screen, 
inclusive 

Erases from start of screen to cursor, 
inclusive 

Erases entire screen, resets lines to single 
width, cursor does not move 

Erase-in-line: 

Erases from cursor to end of line, inclusive 

Erases from start of line to cursor, inclusive 

Erases entire line, cursor does not move 

Inserts Pn lines preceding current line 

Deletes Pn lines from current downward 

Deletes Pn chars from cursor to left 

Primary device attributes request. Terminal 
type and features. Responses are the same as 
to the DECID query. 

Sets cursor to row Pr, column Pc (same as 
CUP) 

Clears tabs, Ps: 0 = at this position, 3 = all 
Media Copy, exits transparent print 
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Table V-6 VT102 Control Sequences (continued) 


Control Sequence Mnemonic Description of Action 


ESC [ 5 i MC 


ESC 

[ 

Pa;...Pa 

h 


SM 

ESC 

1 

Pa;...Pa 

1 


RM 

ESC 

[ 

? Ps;. . . 

;Ps 

h 

SM 

ESC 

[ 

1 Ps;. .. 

;Ps 

1 

RM 

ESC 

( 

Ps;...Ps 

m 


SGR 

ESC 

[ 

5 n 



DSR 

ESC 

[ 

6 n 



DSR 


ESC [ Pt; Pb r 

DECSTBM 

ESC [ 1 x 

DECREQTPARM 


Media Copy. Enters transparent print. Sends 
all characters, except the esc [ 4 i termina¬ 
tion string, to the printer and not the screen. 
All translation and character set selections are 
bypassed. 

Sets ANSI mode, see Table V-7 

Resets ANSI mode, see Table V-7 

Sets DEC mode, see Table V-8 

Resets DEC mode, see Table V-8 

Selects graphic rendition (see Table V-9) 

Device Operating Status request 

Cursor Position Report request. Response is 
ESC [ Pr; Pc R, where Pr is the row and Pc 
is the column. The origin (home) is 1,1. 

Sets top and bottom scrolling margins, respec¬ 
tively. ESC [ r resets margin to full screen. 

Requests Terminal Parameters 


Kermit’s response to DECREQTPARM is: 

ESC [ sol;par;nbits;xspeed;rspeed;clkmul;flags x 

where sol is 1 (terminal reports sent on request), or 2 (this is a report), par tells the parity 
setting: 1 (none), 2 (space), 3 (mark), 4 (odd), 5 (even). The transmit and receive speeds 
xspeed and rspeed are given by a code: 0, 8,16, 24, 32,40,48, 56,64,72, 80, 88, 96, 104, 
112, 120, and 128 corresponding to speeds of 50, 75, 110, 134.5, 150, 200, 300, 600, 
1200, 1800, 2000, 2400, 3600, 4800, 9600, 19200, and 38400 baud or above, clkmul is al¬ 
ways 1 . flags are always reported as 0. 
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Table V-7 lists the parameters for Set and Reset ANSI Mode. 


Table V-7 Set / Reset ANSI Mode Parameters 


Parameter 

Mnemonic 

Mode 

Set (h) 

Reset (1) 

2 

KAM 

Keyboard mode 

Locked 

Unlocked 

4 

IRM 

Insert / Replace Mode 

Insert 

Replace 

20 

LNM 

New line mode 

Display CR as CRLF 

Display CR as CR 


Table V-8 lists the parameters for Set and Reset DEC Mode. 
Table V-8 Set / Reset DEC Mode Parameters 


Parameter 

Mnemonic 

Mode 

Set (h) 

Reset (1) 

1 

DECCKM 

Cursor keys 

Application 

Cursor / Numeric 

2 

DECANM 

ANSI mode 

VT102 

VT52 

5 

DECSCNM 

Screen, whole 

Reverse video 

Normal 

6 

DECOM 

Origin 

Relative 

Absolute 

7 

DECAWM 

Autowrap 

On 

Off 


Table V-9 lists the parameters for Set Graphic Rendition (ESC [ Ps ;.. .Ps m). Colors 
are 1 (red), 2 (green), 4 (blue), or any sum of these, with the result added to 30 for a fore¬ 
ground color or to 40 for a background color, compatible with ANSI.SYS and MS-DOS 
Kermit. 


Table V-9 

Set Graphic Rendition Parameters 

Parameter 

Description 

0 

Attributes 1,4,5,7, and 8 off and restore original colors 

1 

Bold (intensify foreground) 

4 

Underline 

5 

Blink 

7 

Reverse video, per character 

8 

Invisible (Kermit extension) 

30-37 

Foreground color = 30 + colors (Kermit extension) 

40-47 

Background color = 40 + colors (Kermit extension) 
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DEC VT52 Emulator Escape Sequences 

Table V-10 shows the valid escape sequences for VT52 mode, which is entered with the 
command SET TERMINAL TYPE VT52, or upon receipt of ESC [ ? 2 1 (1 is lowercase L) 
when the terminal emulator is in VT102 mode. 


Table V-10 

VT52 Escape Sequences 

Escape 

Sequence 

Description of Action 

ESC 7 

Saves cursor position 

ESC 8 

Restores cursor position 

ESC A 

Cursor up 

ESC B 

Cursor down 

ESC C 

Cursor right 

ESC D 

Cursor left 

ESC F 

Enters graphics mode 

ESC G 

Exits graphics mode 

ESC H 

Cursor home 

ESC I 

Reverse linefeed 

ESC J 

Erases to end of screen 

ESC K 

Erases to end of line 

ESC V 

Prints cursor line 

ESC X 

Exits printer controller (transparent print) 

ESC Y row 

column Direct cursor addressing, offset from Space 

ESC W 

Enters printer controller (transparent print) 

ESC Z 

Identifies terminal (response is ESC / z) 

ESC A 

Enters autoprint mode (printer echoes screen) 

ESC _ 

Exits autoprint mode 

ESC ] 

Prints screen 

ESC = 

Enters alternate keypad mode 

ESC > 

Exits alternate keypad mode 

ESC < 

Returns to ANSI mode 
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Appendix VI 


AOS/VS C-Kermit 


oooo 

This appendix lists the particulars of using C-Kermit on Data General MV- 
series computers with the AOS/VS and AOS/VS-II operating systems. For a 
current list of limitations and restrictions of C-Kermit for AOS/VS, also read the 
files ckcker.bwr and ckdker.bwr that were provided with the C-Kermit 
distribution. 

AOS/VS (Advanced Operating System/Virtual System) is the operating system for the 
Data General Eclipse MV family of minicomputers. It is a multiuser, multitasking operat¬ 
ing system that comes in two basic varieties: AOS/VS itself and an enhanced version 
called AOS/VS II. Outgoing TCP/IP telnet connections can only be established on 
AOS/VS II systems configured with TCP/IP II. 

C-Kermit runs on both AOS/VS and AOS/VS II. As of this writing, the current revisions 
are 1.6x for AOS/VS and 2.2x for AOS/VS II, where the x in the revision number signifies 
a minor update, and appears as a single digit, 0-9. In this book, the term AOS/VS (or 
simply VS) refers to both operating systems, unless explicitly noted otherwise. 

See reference [21] for a general introduction to AOS/VS. Reference [24] is the Command 
Language Interface (CLI) manual. Reference [22] describes the structure and functions of 
the AOS/VS operating system. For information about using AOS/VS CLI commands, you 
can also give the HELP command. 
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C-Kermit must be installed by the AOS/VS system manager. Refer to the file 
ckdins.doc for detailed instructions for installing C-Kermit under AOS/VS and con¬ 
figuring MV system communication devices (particularly serial ports and modems) 
appropriately. 

Using C-Kermit in AOS/VS 

C-Kermit for AOS/VS includes support for serial connections, both direct and dialed, as 
well as for TCP/IP telnet connections. 

Preparing Your AOS/VS Session for Kermit 

AOS/VS systems are normally accessed via Data General DASHER terminals or 
emulators. When you log in to AOS/VS, it automatically sends a DASHER-specific 
“Read Model ID” escape sequence to your terminal. If you have a DASHER terminal or 
emulator, it responds appropriately and your terminal type is set automatically. 

AOS/VS also supports DEC VT-100, 200, and 300 series terminals to a limited extent. To 
identify this type of terminal to AOS/VS, you must issue the following command: 

) characteristics/on/nas/xlt 
where NAS and XLT are defined as follows: 

NAS 

When ON, NAS specifies a non-ANSI standard terminal. On input, this causes a car¬ 
riage return to be converted to a carriage return and a line feed, and a line feed to be 
converted to a carriage return. On output, it causes a line feed to be converted to a 
carriage return and a line feed. 

XLT 

When ON, XLT enables support for the VT 100-compatible family of terminals. Sup¬ 
port for VT 100-compatible terminals must have been specified by the system manager 
in advance during system generation. If you turn on XLT, but still have problems with 
the backspace key, check with the system manager. 

If you are using a speaking device or hardcopy terminal, you can inform AOS/VS with the 
following command: 

) characteristics/hardcopy 

You should also be sure that your terminal has the BMOB characteristic: 

) characteristics/break=bmob 
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This ensures that if C-Kermit ever gets stuck, you can interrupt it by typing CMD-BRK 55 
followed by Ctrl-C and Ctrl-B, which is the normal AOS/VS method for interrupting a 
process. 

To enable Xon/Xoff software flow control on your login terminal, give this command: 

) characteristics/on/ifc/ofc 

and you can enable RTS/CTS hardware flow control as follows: 

) characteristics/on/hifc/hofc 

To use international character sets, you must issue the following command: 

) char/on/8bt 

which causes all 8 bits of each character to be treated as data. You can also use /16BT 
(and, for VT terminals, /xlt/kvt) to enable 16-bit character sets, such as for Japanese 
Kanji. The 8-bit text character set most commonly used in the AOS/VS environment is 
Data General International (DGI, see Table VIII-4 on page 464). 

The changes you make to your console’s characteristics via the characteristics com¬ 
mand are in effect only for the current session. To have them take effect in all of your ter¬ 
minal sessions, you can include the CHARACTERISTICS command that sets them to the 
desired values in your login macro, normally called LOGON.CLI. Check with your system 
manager for more information. 

Starting C-Kermit in AOS/VS 

The name of the C-Kermit executable image is kermit.pr. To see if it exists on your 
system, issue the following command: 

) pathname kermit.pr 

If the system returns an indication that it found kermit.pr, then you should check its 
revision number by issuing a revision command: 

) rev/v kermit.pr 

The revision should be 00.05.188.00, or greater. If it is not, it might lack some of the 
capabilities described in this book; consult your system manager. Otherwise, check to see 
if the KERMIT. CLI macro exists: 

) pathname kermit.cli 


55 This is the DASHER key combination to send a BREAK signal; hold down CMD and press BRK/ESC. 
On other terminals or emulators, use the normal method for sending a BREAK, such as Alt-B in 
MS-DOS Kermit. 
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You can use this macro to start C-Kermit: 
) kermit 


Otherwise, you can start kermit.PR directly by typing: 

) x kermit 

C-Kermit can also be run with redirected input and output. Suppose you have a file called 
input . test containing C-Kermit commands: 

echo Hello from Kermit. 
exit 

and you also have a file called output . test, which is empty, but it has to exist. If you 
start C-Kermit like this: 

) process/block/default/input=input.test/output=output.test kermit 

then, after C-Kermit exits, OUTPUT. TEST has the following contents: 

C-Kermit 5A(188), 23 Nov 92, Data General AOS/VS 
Type ? or HELP for help 
C-Kermit>Hello from Kermit. 

C-Kermit> 


Initialization File 

AOS/VS C-Kermit uses the standard initialization file, CKERMIT.ini. If a file with this 
name exists in your home directory, it is used. Otherwise, if a file of this name exists in 
the UTIL: directory, it is used. The file CKERMOD.INI, if it exists in your home direc¬ 
tory, is executed after ckermit . INI. You can use SED or another text editor to create or 
modify your ckermod . ini file (type x SED filename to start the SED editor, then issue the 
help command for instructions on how to use it). 


Interrupting C-Kermit 

Most C-Kermit commands can be interrupted by typing Ctrl-C. C-Kermit commands, 
such as DIRECTORY or WHO, that work by running the AOS/VS command processor (CLI) 
as an inferior process, must be interrupted with the CLI interrupt sequence, BREAK fol¬ 
lowed by Ctrl-C and then Ctrl-A. 


To interrupt C-Kermit during remote-mode file transfer, type two Ctrl-C characters in a 
row. Ctrl-C is always used for this purpose, no matter what your interrupt character is: 


C-Kermit>send oofa.txt 


(Send a file) 


"AO Sz* @-#Yl~* yE 

"C"C 

"C. . . 

C-Kermit> 


(A packet appears) 

(Type two Ctrl-C's) 

(Ctrl-C is echoed by C-Kermit) 
(The prompt returns) 
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To interrupt C-Kermit during CONNECT mode, use the CONNECT-mode escape character, 
followed by the letter C to get back to the prompt, or any of the other escape-level com¬ 
mands described in Chapter 4. 

In an emergency, the C-Kermit process itself can be interrupted by sending a BREAK sig¬ 
nal and then typing Ctrl-C and Ctrl-B. 

Terminal Emulation 

C-Kermit’s CONNECT command and associated features work in AOS/VS as described in 
Chapter 4. The default CONNECT-mode escape character is Ctrl-Backslash, which is en¬ 
tered on DASHER terminals by holding down the CTRL key and pressing the backslash 
(\) key. 

The default local terminal character-set is DG-Intemational. If this agrees with your ter¬ 
minal or emulator, you need only specify the remote set when selecting your terminal 
character-set, for example: 

C-Kermit >set term char latinl 

Otherwise you must specify the appropriate local set too, for example: 

C-Kermit> set term char latinl Spanish 

File Transfer 

C-Kermit for AOS/VS offers the full range of file transfer features. For text files, 
AOS/VS record format (lines terminated by the single character, linefeed) is automatically 
converted to Kermit’s standard intermediate form during file transfer. 

As in other C-Kermit versions, character-set translation is available. The default file 
character-set is DG-Intemational, so to enable translation the only command you need to 
give is: 

set transfer character-set latinl 

If you are using some other file character-set on your AOS/VS system, you should also 
specify it: 

set file character-set french 
set transfer character-set latinl 

If you always use the same character sets for file transfer, add these commands to your 
CKERMOD. INI file. 
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Table VI-1 AOS/VS Template Characters 


Character Meaning 

+ (plus sign) Matches any character string. 

* (asterisk) Matches any single filename character except a period (.). 
Example: fig* matches FiGl and FIG2, but not fig. or figure. 

(dash) Matches any series of filename characters that does not contain a 
period. Example: test- matches testi and testing, but not test. 1. 

\ (backslash) Omits the specified series of characters from the search. Ex¬ 
ample: +. doc\kermit+ matches all files ending in . doc except for files 
that start with the string kermit. Because backslash is also C-Kermif s 
command-quote character, you must enter two copies of it. 

A (circumflex) Causes the action to be applied to the parent directory instead 
of the current one. Example: A +. doc matches all files in the parent 
directory whose names end in . DOC. 

# (number sign) Causes the action to be applied to all directories beneath the 
current one. Example: # +. doc matches all files in all inferior directories 
with names ending in . doc. 


Sending Files 

In outbound AOS/VS filenames, dollar sign ($) and question mark (?) are converted to 
the letter X unless you have SET FILE NAMES LITERAL. 

You can use AOS/VS templates to specify a group of files in any of C-Kermif s com¬ 
mands that accept wildcard file specifications, as well as in GET commands sent to an 
AOS/VS C-Kermit server. AOS/VS template characters are listed in Table VI-1. 

Receiving Files 

Incoming files are stored in the current directory unless you specified a filename in the 
receive command, or the incoming file header packet includes a pathname, in which case 
C-Kermit attempts to store the file in the specified directory (and fails if the directory does 
not exist or is not writable). 

A file can be created only if you have write access to the directory where the file is to be 
stored. The file is created using your default access control list (ACL), which, unless you 
have changed it with the AOS/VS DEFACL command, grants the site-dependent default ac¬ 
cess control list. 

If a file of the same name already exists in the target directory and C-Kermit’s FILE 
COLLISION is set to BACKUP or OVERWRITE, you must also have write access to the 
previously existing file. C-Kermit will not create, rename, or delete files for you that you 
could not otherwise create, rename, or delete yourself. 
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When AOS/VS C-Kermit receives a file that has the same name as an existing file, it 
might rename the existing file or the incoming file, according to your file COLLISION set¬ 
ting. The new name is the old name with a period and a version number appended. For 
example, oofa . TXT would become oofa . txt . 1. If both OOFA. TXT and oofa . TXT. 1 
existed, an oofa . txt . 2 would be created, and so on. 

Dash (-) characters in incoming filenames are converted to underscores (_) unless you 
have SET FILENAMES LITERAL. 
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Appendix VII 


Other C-Kermit Versions 


C-Kermit is also available for several other computers and operating systems, including 
the Commodore Amiga, the Atari ST, Microware OS-9, and perhaps others by the time 
you read this. Consult the file CKCKER.UPD for news. 

Amiga C-Kermit 


oooo 

This section describes the Commodore Amiga version of C-Kermit. For further 
information, refer to the files ckcker . bwr and ckiker . bwr. 

The Commodore Amiga is a desktop workstation with a graphical user interface called In¬ 
tuition. Its multiprocessing operating system, AmigaDOS, gives you multiple windows 
selectable by mouse. You may create one or more character-oriented Command Line In¬ 
terpreter (CLI) or Shell windows in which to type AmigaDOS commands. Commonly- 
used commands include list to display a list of files, delete to delete a file or files, type 
to display the contents of a file, CD to change directory, INFO to display information about 
system usage, and STATUS to display process status. CLI and Shell are not case-sensitive; 
commands may be entered in uppercase, lowercase, or any mixture. 

AmigaDOS has a hierarchical file system similar to OS/2. File specifications can option¬ 
ally begin with a device name terminated by a colon (:). The directory specification 
shows the path through the directory tree from its root on the given device; the directory 
separator is slash (/), as in UNIX. Upper- and lowercase letters are not distinguished in 
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Amiga file specifications. File specifications that do not begin with a device name are on 
the current device. File specifications that do not have a slash at the beginning (or immed¬ 
iately after the device name) are relative to the current directory. 

Install the KERMIT program in your C : directory or another directory along your PATH, 
and place your initialization file ckermit.ini, your customization file ckermod.ini, 
and your services directory ckermit.ksd in the S: directory. If desired, you can create 
an icon for C-Kermit by using the Icon Editor; create a script file containing the two com¬ 
mands: 

stack 10000 
Kermit 

and save it. Then use the Icon Editor to create a Project icon whose “default tool” is 
C: IconX for this file. 

You can start C-Kermit from the desktop by clicking on its icon (if you made one) or from 
a CLI or Shell window by typing kermit or run kermit. In both cases, C-Kermit creates 
a new window for itself. Before starting C-Kermit in a CLI or Shell window, allocate a 
stack size of at least 10000 with the AmigaDOS stack command as shown above. 

When starting C-Kermit in a CLI or Shell window, you can include command-line options 
(see Chapter 14). If any of these are action options, C-Kermit exits automatically when 
they are complete. If you want to run C-Kermit in this manner without having it create a 
new window, include the -q (quiet) command-line option. 

During interactive operation, Amiga C-Kermit can be interrupted by typing Ctrl-C (hold 
down the Ctrl key and press the C key). A requestor window pops up to let you choose 
whether to quit C-Kermit or continue it. 

Communications and Terminal Emulation 

The default communication device is serial .device/0. Other devices can be 
specified using the same form: type .dev ice /unit -number. You can configure the 
communication device in the Preferences window, including (for a serial device) its speed 
and flow control. Both software (Xon/Xoff) and hardware (RTS/CTS) flow control op¬ 
tions are available. 

Network connections, including TCP/IP and DECnet, can be accomplished by running a 
serial. device emulator over the network link, provided you have the underlying net¬ 
work hardware, software, and connection, and a suitable serial. device emulator. 

The CONNECT command creates an AmigaDOS console device window. Using the default 
Preferences setting, this gives a 23-row by 77-column screen. In AmigaDOS 2.0 and 
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later, you can increase the screen size in Preferences. In AmigaDOS releases prior to 2.0, 
the MoreRows program allows you to increase the size of the Workbench window beyond 
the 640 by 200 default size; increasing the number of rows by 8 and the number of 
columns by 16 will allow a 24-row by 80-column Kermit window. 

The Amiga console driver provides ANSI [3] (similar to VT100) terminal emulation; 
C-Kermit connect mode uses the console driver, and does not provide any particular ter¬ 
minal emulation of its own. 

The default cONNECT-mode escape character is Control-Backslash ( Ctrl-\ ). You can 
use Ctrl-\H to close the serial device and exit connect mode; this turns the DTR signal 
off, causing most modems to hang up the phone line. In addition to the normal CONNECT- 
mode commands, extra session-logging control is available. If a session log file is open, 
the Ctrl-\Q sequence lets you temporarily suspend logging and the Ctrl-\R sequence 
resumes logging if it has been suspended. 

Character-set translation is not available during CONNECT mode. The Amiga’s native 
character set is ISO 8859 Latin Alphabet 1, and it is used during CONNECT mode if parity 
is NONE and you SET COMMAND BYTESIZE 8. Special characters are entered according to 
your keymap, configurable in Preferences, normally using “dead keys.” 

File Transfer 

Amiga C-Kermit supports most of the file transfer features described in this book, includ¬ 
ing character-set translation (Latin-1 is the normal file character-set), the FULLSCREEN file 
transfer display, and the full range of file collision options. 

When sending files, Amiga C-Kermit internally expands wildcards in SEND and MSEND 
commands, as well as in get commands sent to an Amiga C-Kermit server. Asterisk (*) 
stands for any sequence of characters and question mark (?) matches any single character. 
When you use ? in a command, it must be preceded by backslash (\) to suppress its nor¬ 
mal function of displaying a file menu: 

C-Kermit> send cki*.\? 

If the use of Attribute (A) packets has been successfully negotiated, Amiga C-Kermit in¬ 
cludes an A-packet with each file it sends, containing the file’s length, creation date, and 
transfer mode (text or binary). 

When receiving files, Amiga C-Kermit reads the incoming A-packet (if any), sets the 
transfer mode (text or binary) accordingly, and sets the incoming file’s creation date from 
the A-packet if a date is given and attribute date is ON. If an incoming file has the 
same name as an existing file, the selected file collision action is taken. Files that must 
be renamed because of collision have a tilde (-) and a number appended; for example, 
oofa.txt becomes oofa.txt-1; oofa.txt-1 becomes oofa.txt-2, and so on. 
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Atari ST C-Kermit 


oooo 

This section describes the Atari ST version of C-Kermit. For further informa¬ 
tion, refer to the files ckcker . bwr and cksker . bwr. 

The Atari ST is a desktop workstation with a graphical user interface. Its operating sys¬ 
tem, GEMDOS, is normally incapable of running multiple programs concurrently. 

A character-oriented command processor is not furnished with the system, but MSH, a 
product of Mark Williams Company, and Gulam and bash, public-domain offerings, are 
among the command processors that are commonly used. Each of these “shells” is case- 
sensitive; that is, each treats uppercase and lowercase letters as distinct characters in com¬ 
mands and filenames. 

The Atari ST file system is almost identical to the MS-DOS file system. Device names 
and directory structure are the same as in DOS. Device names are a single letter followed 
by a colon (:), and directories are arranged hierarchically, with levels separated by the 
backslash character (\). Filenames may be up to 11 characters long: up to eight characters 
before the period and three after. Even though your shell might care about alphabetic case 
in filenames, GEMDOS itself does not. Besides handling its own native file system and 
disk formats, the Atari ST can also read and write 3.5-inch MS-DOS-format diskettes. 

Installing and Running C-Kermit 

Atari ST C-Kermit supports most, but not all, of C-Kermit’s features. Type SHOW 
features at the C-Kermit prompt for a full accounting of which C-Kermit features are 
available and which are not, or read the cksker . bwr file. 

The C-Kermit program should be installed on a device and in a directory that is in your 
PATH. The initialization files, CKERMIT.INI and CKERMOD.INI, should be stored in 
your home directory, as defined by the environment variable, HOME. 

C-Kermit can be run from the desktop or started from within a command processor. In all 
cases, C-Kermit takes over the full screen. If C-Kermit is run from the desktop, a dialog 
box pops up and asks you for command-line options. It is quite likely that no environment 
variables will be accessible. 

When run from a shell, C-Kermit has access to environment variables if the shell uses the 
Mark Williams C language conventions. Environment variables specific to the Atari ST 
include the following: 
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HOME Used by C-Kermit to find its initialization and other files, and to expand - nota¬ 
tion in file specifications. 

path Used by most shells to find their programs. 

SPEED The serial communication speed for the AUX device. 

BAUD Same as SPEED. 

Assuming C-Kermit is installed as KERMIT. TTP somewhere in your PATH, you can run it 
by typing the word kermit at your command processor prompt. Command-line options are 
accepted; the shell expands any unquoted wildcards, for example in the -s option. The 
available wildcard characters depend on the shell, but usually * matches any sequence of 
characters not containing a period or backslash and ? matches any single character except 
period. 

If you start C-Kermit with command-line action options (see Chapter 14), C-Kermit ex¬ 
ecutes the given commands and exits. In this mode of operation, C-Kermit’s standard in¬ 
put and output can be redirected and C-Kermit can be used in a pipeline with msh or bash, 
but not with Gulam, which does not support pipes. In msh, pipes are text-only. 

If you start C-Kermit without command-line action options, it issues its prompt and runs 
interactively. The interruption character is Control-C, which can be taken over by the run¬ 
time library at various times; sometimes you must type it several times. 

Communications and Terminal Emulation 

Atari ST C-Kermit supports serial connections only. The only serial communication 
device is AUX, and this is C-Kermit’s default communication device. Available speeds 
range from 50 to 19200 bps, but flow control is problematic due to limitations of the 
underlying serial device driver. 

The communication speed cannot be read from the device. You have to set it with the set 
speed command or use the speed environment variable, which C-Kermit will read auto¬ 
matically if it is defined. 

The terminal emulation is performed by the GEMDOS console driver. The terminal is a 
superset of the DEC VT-52 (see Table V-10 on page 440). VT52 emulation is effective 
during command mode, CONNECT mode, and file transfer. 

The CONNECT-mode escape character is Control-Rightbracket (Ctrl-]). There is no spe¬ 
cial provision for entering or displaying accented characters, but you can use them trans¬ 
parently to C-Kermit if your keyboard and display support them and if they are configured 
to use them, and if you have told C-Kermit to SET COMMAND BYTESIZE 8, and, for 
CONNECT-mode, SET TERMINAL BYTESIZE 8. 
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File Transfer 

Atari ST C-Kermit expands wildcards internally in the send and MSEND commands, 
recognizing * and ? as wildcard characters, and it expands a leading tilde (-) character in 
file specifications according to the definition of your HOME environment variable. Back¬ 
slash characters within filenames must be doubled, for example: 

C-Kermit> send c: \\mydirWoofa.txt 

File attributes are sent along with each file, if successfully negotiated with the other Ker- 
mit program. These include transfer mode (text or binary, according to your most recent 
set file type command; text by default), creation date, and size. 

When receiving files, Atari ST C-Kermit obtains the transfer mode (text or binary) from 
the incoming Attribute packet, if any, and this overrides the current f il e type setting. 
The file size is also read from the Attribute packet and the file is rejected if it is bigger 
than available disk space (as shown by the SPACE command) unless you have SET at¬ 
tribute length off. Incoming files are stored with the creation date from the Attribute 
packet or, if there is no Attribute packet or if you have SET attribute date off, they are 
created with the current date and time. 

If a file arrives that has the same name as an existing file, it is handled according to your 
FILE COLLISION setting. Renaming of files is done by inserting digits between the 
filename and filetype, for example oofa.txt becomes oofa0000.txt; oofa0000.txt 
becomes oofa0001.txt, and so on. As with other C-Kermit versions, the default file 
collision action is BACKUP. 

OS-9 C-Kermit 


oooo 

This section describes the OS-9 version of C-Kermit. For further information, 
refer to the files CKCKER. BWR and CK9KER. BWR. 

OS-9/68000 is a multiuser, multitasking operating system designed to run on all Motorola 
68000-family processors. A related operating system, OS-9000, is more portable; for ex¬ 
ample, to Intel as well as to various RISC processors. However, OS-9 C-Kermit has not, 
as of this writing, been tested under OS-9000. For news about this, as well as further in¬ 
formation about C-Kermit under OS-9, please read the file CK9KER.BWR. 

OS-9’s 100% ROM-able, fast, compact code in conjunction with its real-time capabilities 
make OS-9/68000 ideal for ROM-based systems used in measuring and control systems in 
scientific and industrial spheres. Yet, a full disk-based OS-9 system offers a program 
development environment similar to UNIX, including limited UNIX software compatibil- 
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ity at the C source-code level and conformance to the UNIX input/output and task models 
as well as a UNIX-like shell and networking environment. 

The basic commands of OS-9 are somewhat different from their UNIX counterparts: 


DEL 

Deletes a file 

DELDIR 

Deletes a directory 

MAKDIR 

Creates a directory 

DIR 

Displays a directory listing 

PROCS 

Shows processes currently running 

LIST 

Displays the contents of a text file 

CWD 

Changes working directory 

PD 

Prints working directory 


Command references (like all references to names on OS-9/68000) are case-independent. 
All commands can be given a -? switch, which displays a brief (usually sufficient) help 
message. 

OS-9 allows redirection of standard input, standard output, and standard error, just like 
UNIX, and supports command pipelines as well as background execution of programs and 
commands. 

The OS-9 File System 

All devices (terminal lines, networks, disks) can have arbitrary names but the usual con¬ 
ventions are: 

Terminal devices: 


term 

The console terminal 

tl 

Terminal line number 1 

tn 

Terminal line number n 

Hard disks: 

hO 

Hard disk number 0 

hi 

Hard disk number 1 

hn 

Hard disk number n 

Diskettes: 

dO 

Diskette drive number 0 

dl 

Diskette drive number 1 

dn 

Diskette drive number n 


OS-9 C-Kermit 
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Directories are hierarchical, as in UNIX, MS-DOS, and OS/2. The directory separator is 
slash (/). A pathname (file specification) starting with a slash must always include a 
device name as the first field. Pathnames that do not start with a slash are relative to the 
current device and directory. 

OS-9/68000 files are sequential streams of 8-bit bytes, just like in UNIX, except that car¬ 
riage return (CR, ASCII 13) is the line terminator, rather than linefeed (LF, ASCII 10). 
Binary files are simply streams of arbitrary 8-bit bytes. The OS-9 operating system and 
utilities are “8-bit clean,” so text files can use any character set that is compatible with 
your display and data entry devices, for example ISO 8859-1 Latin Alphabet 1. 

The OS-9 Console 

The console terminal is either a real terminal, or the screen and keyboard of a workstation 
such as a Macintosh, Amiga, or Atari ST that is running OS-9. Terminal emulation is not 
done by OS-9 C-Kermit, but rather by the real terminal or the workstation console driver. 
This includes the capability to display national and international characters. As with other 
C-Kermit versions, you must set command bytesize 8 in order to enter and view 8-bit 
characters. 

Using OS-9 C-Kermit 

The C-Kermit program should be installed somewhere in your OS-9 PATH. Start it 
simply by typing its name, kermit. It reads its initialization, dialing directory, and services 
directory files from your home directory. 

The OS-9 version of C-Kermit is very similar to the UNIX version. The primary dif¬ 
ferences between OS-9 and UNIX are the names of the common system commands and 
the line terminator used in text files. 

If you start OS-9 C-Kermit with command-line action options (see Chapter 14), C-Kermit 
executes the given commands and exits. The shell expands any unquoted wildcards on the 
command line, for example in the -s option. The available wildcard characters are *, 
which matches any sequence of characters of any length, and ?, which matches any single 
character. 

If you start C-Kermit without command-line action options, it issues its prompt and runs 
interactively. C-Kermit’s interruption character is Control-C. C-Kermit also expands 
wildcards itself, using the same notation as the OS-9 shell, for example: 

C-Kermit> send ck*.\? 

Note that the question mark must be prefixed by backslash to override its normal function 
of giving a help message. 
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When receiving files, OS-9 C-Kermit handles the full range of file collision options. 

When C-Kermit renames a file because of a collision, it appends an underscore and a digit 

to the file name: 

oofa.txt 

becomes: 

oofa.txt_l 

oof a. txt_l becomes oof a. txt_2, and so on. 

The commands and operation of OS-9 C-Kermit should be identical to those of UNIX 
C-Kermit, with the exceptions noted above and in the “beware file,” CK9KER.BWR. 
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Appendix VIII 


Character Set Tables 


The standard structure for character sets is specified in ISO Standard 4873 [38] and il¬ 
lustrated in Figure VIII-1 on the next page. 

A standard 7-bit character set consists of 32 control characters (CO), 94 graphic (printing) 
characters (GL = Graphics Left), plus the characters Space (SP) and Delete (DEL), for a 
total of 128 characters, as shown in the left half of the figure. 

The left half of a standard 8-bit character set is the 7-bit 128-character set known as the 
International Reference Version of ISO 646 [36], which happens to be identical to 
ASCII [1] and which is listed in greater detail in Tables VIII-1 and VIII-2 on pages 
461-462. Many nonstandard 8-bit character sets, such as PC code pages, also use ASCII 
as their left halves. 

The right half of a standard 8-bit character set has a similar structure to the left half. 
There is a second control region (Cl) with 32 additional control characters and a second 
graphic region (GR = Graphics Right) with 94 or 96 additional graphic characters. The 
best-known standard 8-bit character sets are those specified by ISO Standard 8859 [39]: 
the Latin Alphabets. The blank GR area in the figure can have any of the various Latin 
Alphabets plugged into it: Latin-1, Latin-2, Latin/Greek, Latin/Arabic, Latin/Hebrew, 
Latin/Cyrillic, and so on. The blank Cl area is most commonly used for the control 
characters specified by ISO Standard 6429 [41]. A 94-character graphics set does not use 
the 10/0 and 15/15 positions, shown gray in the figure. A 96-character set does use them. 
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Figure VIII-1 Structure of a Standard 8-Bit Character Set 


Nonstandard 8-bit character sets, such as PC code pages or the Macintosh and NeXT 
character sets, use Cl and sometimes even CO for graphic characters. 

Each character in an 8-bit character set is represented internally by a number in the range 
0-255. This can be a simple decimal number, like 65 for uppercase letter A, the 
hexadecimal (base 16) or octal (base 8) equivalent, or the column and row position from 
the table, for example 04/01 for uppercase letter A, where the value (code) of a character 
is 16 times the column number plus the row number (16 x 4 + 1 = 65). 

Rules for designation and invocation of character sets during data transmission are 
specified in ISO Standard 2022 [37]. In the 8-bit communications environment, a charac¬ 
ter with its 8th (high order) bit set to 0 denotes a character from the left half and a charac¬ 
ter with its 8th bit set to 1 denotes a right-half character. The rules for transmission of 
8-bit characters in the 7-bit communication environment are, predictably, somewhat more 
complicated. 
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The ASCII and ISO 646IRV Character Set 


Key: Dec = decimal value. Hex = hexadecimal value, A X = Ctrl-X. 
Table VIII-1 Character Codes of ASCII and ISO 646 IRV 


Dec Hex 

Name 

Char 

Dec Hex 

Char 

Dec Hex 

Char 

Dec Hex 

Char 

000 00 

NUL 

A @ 

032 20 

SP 

064 40 

@ 

096 60 

‘ 

001 01 

SOH 

A A 

033 21 

f 

065 41 

A 

097 61 

a 

002 02 

STX 

A B 

034 22 

H 

066 42 

B 

098 62 

b 

003 03 

ETX 

A C 

035 23 

# 

067 43 

C 

099 63 

c 

004 04 

EOT 

A D 

036 24 

$ 

068 44 

D 

100 64 

d 

005 05 

ENQ 

A E 

037 25 

% 

069 45 

E 

101 65 

e 

006 06 

ACK 

A F 

038 26 

& 

070 46 

F 

102 66 

f 

007 07 

BEL 

A G 

039 27 

’ 

071 47 

G 

103 67 

g 

008 08 

BS 

A H 

040 28 

( 

072 48 

H 

104 68 

h 

009 09 

HT 

A I 

041 29 

) 

073 49 

I 

105 69 

i 

010 0A 

LF 

A J 

042 2A 

* 

074 4A 

J 

106 6A 

j 

Oil 0B 

VT 

A K 

043 2B 

+ 

075 4B 

K 

107 6B 

k 

012 0C 

FF 

A L 

044 2C 

, 

076 4C 

L 

108 6C 

1 

013 0D 

CR 

A M 

045 2D 

- 

077 4D 

M 

109 6D 

m 

014 OE 

SO 

A N 

046 2E 


078 4E 

N 

110 6E 

n 

015 OF 

SI 

A o 

047 2F 

/ 

079 4F 

O 

111 6F 

0 

016 10 

DLE 

A P 

048 30 

0 

080 50 

P 

112 70 

P 

017 11 

CD1 

A Q 

049 31 

1 

081 51 

Q 

113 71 

q 

018 12 

DC2 

A R 

050 32 

2 

082 52 

R 

114 72 

r 

019 13 

DC3 

A S 

051 33 

3 

083 53 

S 

115 73 

s 

020 14 

DC4 

A T 

052 34 

4 

084 54 

T 

116 74 

t 

021 15 

NAK 

A U 

053 35 

5 

085 55 

U 

117 75 

u 

022 16 

SYN 

A V 

054 36 

6 

086 56 

V 

118 76 

V 

023 17 

ETB 

A W 

055 37 

7 

087 57 

w 

119 77 

w 

024 18 

CAN 

A X 

056 38 

8 

088 58 

X 

120 78 

X 

025 19 

EM 

A Y 

057 39 

9 

089 59 

Y 

121 79 

y 

026 1A 

SUB 

A Z 

058 3A 

: 

090 5A 

Z 

122 7A 

Z 

027 IB 

ESC 

A [ 

059 3B 

* 

091 5B 

[ 

123 7B 

{ 

028 1C 

FS 

A \ 

060 3C 

< 

092 5C 

\ 

124 1C 

1 

029 ID 

GS 

A ] 

061 3D 


093 5D 

] 

125 7D 

} 

030 IE 

RS 

AA 

062 3E 

> 

094 5E 

A 

126 7E 

~ 

031 IF 

US 

A 

063 3F 

? 

095 5F 

- 

127 7F 

DEL 
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7-Bit Control Characters 


Table VIII-2 lists the 7-bit control characters used in the ASCII ISO 646 IRV character 
sets and in character sets based upon them, including the ISO 646 national sets and the 
ISO 8858 international sets as well as IBM code pages and other private sets. The official 
abbreviation and full name of each character is shown, along with the control-key com¬ 
bination normally used to produce each character on a US keyboard. 


Table VIII-2 7-Bit CO Control Characters 



00 



01 


07 

00 

NUL 

A @ 

Null 

DLE 

A P 

Data Link Escape 

01 

SOH 

"A 

Start of Heading 

DC1 

A Q 

Device Control 1 

02 

STX 

A B 

Start of Text 

DC 2 

A R 

Device Control 2 

03 

ETX 

A C 

End of Text 

DC3 

A S 

Device Control 3 

04 

EOT 

A D 

End of Transmission 

DC4 

A T 

Device Control 4 

05 

ENQ 

A E 

Enquiry 

NAK 

A U 

Negative Acknowledge 

06 

ACK 

A F 

Acknowledge 

SYN 

A V 

Synchronous Idle 

07 

BEL 

A G 

Bell 

ETB 

A W 

End of Transmission Block 

08 

BS 

A H 

Backspace 

CAN 

A x 

Cancel 

09 

HT 

"I 

Horizontal Tab 

EM 

A Y 

End of Medium 

10 

LF 

A J 

Line Feed 

SUB 

A Z 

Substitute 

11 

VT 

*K 

Vertical Tab 

ESC 

A [ 

Escape 

12 

FF 

A L 

Form Feed 

FS 

A \ 

File Separator 

13 

CR 

A M 

Carriage Return 

GS 

A ] 

Group Separator 

14 

SO 

A N 

Shift Out 

RS 


Record Separator 

15 

SI 

A 0 

Shift In 

US 

_ 

Unit Separator del a ? Delete 
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7-Bit Roman Character Sets 


Table VIII-3 shows the 7-bit character sets used by C-Kermit. These sets are identical to 
ASCn (Table VIII-1) except in the positions shown in this table. ASCII is United States 
ANSI X3.4-1986, which is the same as the ISO 646 International Reference Version. 
British, French, German, Hungarian, Italian, Japanese Roman, Norwegian, Portuguese, 
Spanish, and Swedish are ISO 646 national versions registered in the ISO International 
Register of Coded Character Sets. The others are taken from DEC VT terminal manuals 
and other sources. The Icelandic 7-bit set, rarely used any more, also includes two- 
character sequences to represent vowels with acute accents, not shown in the table. 


Table VIII-3 7-Bit National Character Sets, Differences from ASCII 


Row/Column 

Decimal 

Hexadecimal 

ASCII 

2/03 

35 

23 

# 

4/00 

64 

40 

@ 

5/11 

91 

5B 

[ 

5/12 

92 

5C 

\ 

5/13 

93 

5D 

] 

5/14 

94 

5E 

A 

5/15 

95 

5F 

6/00 

96 

60 

7/11 

123 

7B 

{ 

7/12 

124 

7C 

1 

7/13 

125 

7D 

} 

7/14 

126 

7E 

British 

£ 

@ 

[ 

\ 

] 

- 


- 

{ 

1 

} 

~ 

Chinese Roman 

# 

@ 

[ 

¥ 

] 

- 

_ 

i 

{ 

1 

1 

- 

Danish 

# 

@ 

JE 

0 

A 

- 

_ 

■ 

ae 

0 

4 

~ 

Dutch 

£ 

X 

y 

X 

I 


_ 

■ 

•• 

/ 

X 

’ 

Finnish 

# 

@ 

A 

0 

A 

U 

_ 

e 

a 

6 

4 

ii 

French 

£ 

a 

O 

9 

§ 

- 

_ 

P 

6 

u 

b 

•• 

Fr-Canadian 

# 

4 

a 

9 

e 

1 

_ 

6 

e 

u 

b 

u 

German 

# 

§ 

A 

O 

u 

- 

_ 

- 

a 

6 

ii 

6 

Hungarian 

# 

A 

E 

O 

u 

- 

_ 

u 

e 

6 

ii 

rr 

Icelandic 

# 

P 

D 

\ 

JE 

0 

_ 

b 

a 

i 

ae 

6 

Italian 

£ 

§ 

O 

9 

e 

- 

_ 

U 

h 

6 

b 

l 

Japanese Roman 

# 

@ 

[ 

¥ 

i 

- 

_ 

/ 

( 

1 

} 

- 

Norwegian 

§ 

@ 

JE 

0 

A 


— 

/ 

ae 

0 

4 

i 

Portuguese 

# 


A 

c 

o 


_ 

i 

a 

9 

6 

~ 

Spanish 

£ 

§ 

i 

N 

6 


_ 

■ 

o 

n 

9 

- 

Swedish 

# 

E 

A 

O 

A 

u 

_ 

6 

a 

6 

4 

ii 

Swiss 

u 

4 

e 

9 

e 

1 

e 

6 

a 

0 

ii 

u 
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West European Character Sets 

Table VIII-4 shows the graphic characters of the right half of ISO 8859-1 Latin Alphabet 
1, which is supported as both a transfer character-set and a file character-set by C-Kermit, 
along with the code values in Latin-1, the DEC Multinational Character Set (MCS), the 
Data General International Character Set (DGI), Kermit’s Macintosh Extended Latin 
character set (MAC), the NeXT workstation character set, and PC code pages 437 and 
850. Characters shown in italics in the MAC column differ from the US version of the 
Apple Quickdraw character set. Characters that are not present in Latin-1 cannot be trans¬ 
lated by Kermit. 


Table VIII-4 West European Character Sets 


Character 

Name 

Latin-1 

dec hex 

MCS 

dec hex 

DGI 

dec hex 

MAC 

dec hex 

NeXT 

dec hex 

CP437 

dec hex 

CP850 

dec hex 


No-break space 

160 AO 

160 AO 

160 A0 

202 CA 

128 80 

255 FF 

255 FF 

i 

Inverted exclamation 

161 A1 

161 A1 

171 AB 

193 Cl 

161 A1 

173 AD 

173 AD 


Cent sign 

162 A2 

162 A2 

167 A7 

162 A2 

162 A2 

155 9B 

189 8B 

£ 

Pound sign 

163 A3 

163 A3 

168 A8 

163 A3 

163 A3 

156 9C 

156 9C 

D 

Currency sign 

164 A4 

168 A8 

166 A6 

219 DB 

168 A8 


207 CF 

¥ 

Yen sign 

165 A5 

165 A5 

181 B5 

180 B4 

165 A5 

157 9D 

190 BE 

1 

Broken bar 

166 A6 



201 C9 

181 B5 


221 DD 

§ 

Paragraph sign 

167 A7 

167 A7 

187 BB 

164 A4 

167 A7 

021 15 

021 15 

- 

Diaeresis 

168 A8 


189 BD 

172 AC 

200 C8 


249 F9 

© 

Copyright sign 

169 A9 

169 A9 

173 AD 

169 A9 

160 A0 


184 B8 

a 

Feminine ordinal 

170 AA 

170 AA 

170 A A 

187 BB 

227 E3 

166 A6 

166 A6 

« 

Left angle quotation 

171 AB 

171 AB 

176 B0 

199 C7 

171 AB 

174 AE 

174 AE 

— i 

Not sign 

172 AC 


161 A1 

194 C2 

190 BE 

170 AA 

170 AA 

- 

Soft hyphen 

173 AD 

173 AD 


208 DO 



240 F0 

® 

Registered trade mark 

174 AE 


174 AE 

168 A8 

176 B0 


169 A9 

- 

Macron 

175 AF 



248 F8 

197 C5 


238 EE 

o 

Degree sign, ring 

176 BO 

176 B0 

188 BC 

161 A1 

248 F8 


248 F8 

± 

Plus-minus sign 

177 B1 

177 B1 

182 B6 

177 B1 

209 D1 

241 FI 

241 FI 

2 

Superscript two 

178 B2 

178 B2 

164 A4 

170 AA 

201 C9 

253 FD 

253 FD 
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Table VIII-4 West European Character Sets (continued) 


Character 

Name 

Latin-1 

dec hex 

MCS 

dec hex 

DGI 

dec hex 

MAC 

dec hex 

NeXT 

dec hex 

CP437 

dec hex 

CP850 

dec hex 

3 

Superscript three 

179 B3 

179 B3 

165 A5 

173 AD 

204 CC 


252 FC 

- 

Acute accent 

180 B4 

180 B4 

190 BE 

171 AB 

194 C2 


239 EF 


Micro sign 

181 B5 

181 B5 

163 A3 

181 B5 

157 9D 

230 E6 

230 E6 

1 

Pilcrow sign 

182 B6 

182 B6 

178 B2 

166 A6 

182 B6 

020 14 

244 F4 

• 

Middle dot 

183 B7 

183 B7 

185 B9 

165 A5 

180 B4 

250 FA 

250 FA 

> 

Cedilla 

184 B8 

184 B8 


252 FC 

184 B8 


247 F7 

l 

Superscript one 

185 B9 

185 B9 


176 B0 

192 CO 


251 FB 

g 

Masculine ordinal 

186 BA 

186 BA 

169 A9 

188 BC 

235 EB 

167 A7 

167 A7 

» 

Right angle quotation 

187 BB 

187 BB 

177 B1 

200 C8 

187 BB 

175 AF 

175 AF 


One quarter 

188 BC 

188 BC 


178 B2 

210 D2 

172 AC 

172 AC 

X 

One half 

189 BD 

189 BD 

162 A2 

179 B 3 

211 D3 

171 AB 

171 AB 

X 

Three quarters 

190 BE 



186 BA 

212 D4 


243 F3 

i 

Inverted question mark 

191 BF 

191 BF 

172 AC 

192 CO 

191 BF 

168 A8 

168 A8 

A 

A grave 

192 CO 

192 CO 

193 Cl 

203 CB 

129 81 


183 B7 

A 

A acute 

193 Cl 

193 Cl 

192 CO 

231 E7 

130 82 


181 B5 

A 

A circumflex 

194 C2 

194 C2 

194 C2 

229 E5 

131 83 


182 B6 

A 

A tilde 

195 C3 

195 C3 

196 C4 

204 CC 

132 84 


199 C7 

A 

A diaeresis 

196 C4 

196 C4 

195 C3 

128 80 

133 85 

142 8E 

142 8E 

A 

A ring above 

197 C5 

197 C5 

197 C5 

129 81 

134 86 

143 8F 

143 8F 

JE 

A with E digraph 

198 C6 

198 C6 

198 C6 

174 AE 

225 El 

146 92 

146 92 

C 

C Cedilla 

199 C7 

199 C7 

199 C7 

130 82 

135 87 

128 80 

128 80 

E 

E grave 

200 C8 

200 C8 

201 C9 

233 E9 

136 88 


212 D4 

E 

E acute 

201 C9 

201 C9 

200 C8 

131 83 

137 89 

144 90 

144 90 

E 

E circumflex 

202 CA 

202 CA 

202 CA 

230 E6 

138 8A 


210 D2 

E 

E diaeresis 

203 CB 

203 CB 

203 CB 

232 E8 

139 8B 


211 D3 

I 

I grave 

204 CC 

204 CC 

205 CD 

237 ED 

140 8C 


222 DE 

I 

I acute 

205 CD 

205 CD 

204 CC 

234 EA 

141 8D 


214 D6 

i 

I circumflex 

206 CE 

206 CE 

206 CE 

235 EB 

142 8E 


215 D7 

I 

I diaeresis 

207 CF 

207 CF 

207 CF 

236 EC 

143 8F 


216 D8 
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Table VIII-4 West European Character Sets (continued) 


Character 

Name 

Latin-1 

dec hex 

MCS 

dec hex 

DGI 

dec hex 

MAC 

dec hex 

NeXT 

dec hex 

CP437 

dec hex 

CP850 

dec hex 

D 

Icelandic Eth 

208 DO 



220 DC 

144 90 


209 D1 

N 

N tilde 

209 D1 

209 D1 

208 DO 

132 84 

145 91 

165 A5 

165 A5 

6 

0 grave 

210 D2 

210 D2 

210 D2 

241 FI 

146 92 


277 E3 

6 

O acute 

211 D3 

211 D3 

209 D1 

238 EE 

147 93 


224 E0 

6 

O circumflex 

212 D4 

212 D4 

211 D3 

239 EF 

148 94 


226 E2 

6 

O tilde 

213 D5 

213 D5 

213 D5 

205 CD 

149 95 


229 E5 

0 

0 diaeresis 

214 D6 

214 D6 

212 D4 

133 85 

150 96 

153 99 

153 99 

X 

Multiplication sign 

215 D7 



165 AS 

158 9E 


158 9E 

0 

O oblique stroke 

216 D8 

216 D8 

214 D6 

175 AF 

233 E9 


157 9D 

U 

U grave 

217 D9 

217 D9 

217 D9 

244 F4 

151 97 


235 EB 

U 

U acute 

218 DA 

218 DA 

216 D8 

242 F2 

152 98 


233 E9 

U 

U circumflex 

219 DB 

219 DB 

218 DA 

243 F3 

153 99 


234 EA 

u 

U diaeresis 

220 DC 

220 DC 

219 DB 

134 86 

154 9A 

1549A 

154 9A 

Y 

Y acute 

221 DD 

221 DD 


160 A0 

155 9B 


237 ED 

F 

Icelandic Thom 

222 DE 



222 DE 

156 9C 


231 E7 

6 

German sharp s 

223 DF 

223 DF 

252 FC 

167 A7 

251 FB 

225 El 

225 El 

a 

a grave 

224 E0 

224 E0 

225 El 

136 88 

213 D5 

133 85 

133 85 

a 

a acute 

225 El 

225 El 

224 E0 

135 87 

214 D6 

160 A0 

160 A0 

a 

a circumflex 

226 E2 

226 E2 

226 E2 

137 89 

215 D7 

131 83 

131 83 

a 

a tilde 

227 E3 

227 E3 

228 E4 

139 8B 

216 D8 


198 C6 

a 

a diaeresis 

228 E4 

228 E4 

227 E3 

138 8A 

217 D9 

132 84 

132 84 

a 

a ring above 

229 E5 

229 E5 

229 E5 

140 8C 

218 DA 

134 86 

134 86 

as 

a with e digraph 

230 E6 

230 E6 

230 E6 

190 BE 

241 FI 

145 91 

145 91 

9 

c cedilla 

231 E7 

231 E7 

231 E7 

141 8D 

219 DB 

135 87 

135 87 

e 

e grave 

232 E8 

232 E8 

233 E9 

143 8F 

220 DC 

138 8A 

138 8A 

e 

e acute 

233 E9 

233 E9 

232 E8 

142 8E 

221 DD 

130 82 

130 82 

e 

e circumflex 

234 EA 

234 EA 

234 EA 

144 90 

222 DE 

136 88 

136 88 

e 

e diaeresis 

235 EB 

235 EB 

235 EB 

145 91 

223 DF 

137 89 

137 89 

i 

i grave 

236 EC 

236 EC 

237 ED 

147 93 

224 E0 

141 8D 

141 8D 
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Table VIII-4 West European Character Sets (continued) 


Character 

Name 

Latin-1 

dec hex 

MCS 

dec hex 

DGI 

dec hex 

MAC 

dec hex 

NeXT 

dec hex 

CP437 

dec hex 

CP850 

dec hex 

1 

i acute 

237 ED 

237 ED 

236 EC 

146 92 

226E2 

161 A1 

161 A1 

1 

i circumflex 

238 EE 

238 EE 

238 EE 

148 94 

228 E4 

140 8C 

140 8C 

i* 

i diaeresis 

239 EF 

239 EF 

239 EF 

149 95 

229 E5 

139 8B 

139 8B 

6 

Icelandic eth 

240 FO 



221 DD 

230 E6 


208 DO 

n 

n tilde 

241 FI 

241 FI 

240 FO 

150 96 

231 E7 

164 A4 

164 A4 

6 

o grave 

242 F2 

242 F2 

242 F2 

152 98 

236 EC 

149 95 

149 95 

6 

o acute 

243 F3 

243 F3 

241 FI 

151 97 

237 ED 

162 A2 

162 A2 

6 

o circumflex 

244 F4 

244 F4 

243 F3 

153 99 

238 EE 

147 93 

147 93 

6 

o tilde 

245 F5 

245 F5 

245 F5 

155 9B 

239 EF 


228 E4 

6 

o diaeresis 

246 F6 

246 F6 

244 F4 

154 9A 

240 F0 

148 94 

148 94 

- 

Division sign 

247 F7 



214 D6 

159 9F 

246 F6 

246 F6 

0 

o oblique stroke 

248 F8 

248 F8 

246 F6 

191 BF 

249 F9 


155 9B 

u 

u grave 

249 F9 

249 F9 

249 F9 

157 9D 

242 F2 

151 97 

151 97 

u 

u acute 

250 FA 

250 FA 

248 F8 

156 9C 

243 F3 

163 A3 

163 A3 

u 

u circumflex 

251 FB 

251 FB 

250 FA 

158 9E 

244 F4 

150 96 

150 96 

U 

u diaeresis 

252 FC 

252 FC 

251 FB 

159 9F 

246 F6 

129 81 

129 81 

9 

y acute 

253 FD 



224 E0 

247 F7 


236 EC 

t> 

Icelandic thorn 

254 FE 



223 DF 

252 FC 


231 E7 

y 

y diaeresis 

255 FF 

255 FF 

253 FD 

216 D8 

253 F3 

152 98 

152 98 

1 

Dotless i 




245 F5 

245 F5 


213 D5 

L 

L with stroke 


195 C3 


195 C3 

232 E8 



1 

1 with stroke 


212 D4 


212 D4 

248 F8 



(E 

O with E digraph 


215 D7 

215 D7 

206 CE 

234 EA 



ce 

o with e digraph 


247 F7 

247 F7 

207 CF 

250 FA 



Y 

Y diaeresis 


221 DD 

221 DD 

216 D8 




f 

Florin sign 



180 B4 

196 D4 

166 A6 

159 9F 

159 9F 
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East European Character Sets 

Table VIII-5 shows the graphic characters of the right half of ISO 8859 Latin Alphabet 2 
for East European languages, which is supported as both a transfer character-set and a file 
character-set by C-Kermit, along with the code values in Latin-2 and PC code page 852. 


Table VIII-5 Table VIII-5 

East European Character Sets East European Sets (continued) 


Character 

Latin-2 

CP852 

Character 

Latin-2 

CP852 


Name 

dec hex 

dec hex 


Name 

dec hex 

dec hex 


No-break space 

160 AO 

255 FF 

s 

s acute 

182 B6 

152 98 

A 

A ogonek 

161 A1 

164 A4 

- 

Caron 

183 B7 

243 F3 

* 

Breve 

162 A2 

244 F4 


Cedilla 

184 B8 

247 F7 

L 

L with stroke 

163 A3 

157 9D 

S 

s caron 

185 B9 

231 E7 

a 

Currency sign 

164 A4 

207 CF 

§ 

s cedilla 

186 BA 

173 AD 

L 

L caron 

165 A5 

149 95 

f 

t caron 

187 BB 

156 9C 


S acute 

166 A6 

151 97 

z 

z acute 

188 BC 

171 AB 

S 


Paragraph sign 

167 A7 

245 F5 

Double acute 

189 BD 

241 FI 

§ 

l 

Diaeresis 

168 A8 

249 F9 

z caron 

190 BE 

167 A7 

S 

S caron 

169 A9 

230 E6 

t 

z dot above 

191 BF 

190 BE 

§ 

S cedilla 

170 A A 

184 B8 

R 

R acute 

192 CO 

232 E8 

T 

T caron 

171 AB 

155 9B 

A 

A acute 

193 Cl 

181 B5 


Z acute 

172 AC 

141 8D 

A 

A circumflex 

194 C2 

182 B6 

Z 


Soft hyphen 

173 AD 

170 AA 

A 

A breve 

195 C3 

198 C6 

z 

Z caron 

174 AE 

166 A6 

A 

A diaeresis 

196 C4 

142 8E 



175 AF 

189 BD 

L 

L acute 

197 C5 

145 91 

z 

Z dot above 


o 

Degree sign, ring 

176 BO 

248 F8 

C 

C acute 

198 C6 

143 8F 


a ogonek 

177 B1 

165 A5 

C 

C cedilla 

199 C7 

128 80 


Ogonek 

178 B2 

242 F2 

c 

C caron 

200 C8 

172 AC 

1 

1 with stroke 

179 B3 

136 88 

E 

E acute 

201 C9 

144 90 

' 

Acute accent 

180 B4 

239 EF 

E 

E ogonek 

202 CA 

168 A8 

r 

1 caron 

181 B5 

150 96 

E 

E diaeresis 

203 CB 

211 D3 
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Table VIII-5 Table VIII-5 

East European Sets (continued) East European Sets (continued) 


Character 

Name 

Latin-2 

dec hex 

CP852 

dec hex 

Character 

Name 

Latin-2 

dec hex 

CP852 

dec hex 

E 

E caron 

204 CC 

183 B7 

i 

c caron 

232 E8 

159 9F 

f 

I acute 

205 CD 

214 D6 

6 

e acute 

233 E9 

130 82 

I 

I circumflex 

206 CE 

215 D7 

9 

e ogonek 

234 EA 

169 A9 

D 

D caron 

207 CF 

210 D2 

e 

e diaeresis 

235 EB 

137 89 

D 

D stroke 

208 DO 

209 D1 

S 

e caron 

236 EC 

216 D8 





i 

i acute 

237 ED 

161 A1 

N 

N acute 

209 D1 

227 E3 









i 

i circumflex 

238 EE 

140 8C 

N 

N caron 

210 D2 

213 D5 









d 

d caron 

239 EF 

212 D4 

6 

O acute 

211 D3 

224 E0 









6 

d stroke 

240 F0 

208 DO 

6 

O circumflex 

212 D4 

226 E2 









n 

n acute 

241 FI 

228 E4 

6 

O double acute 

213 D5 

138 8A 









n 

n caron 

242 F2 

229 E5 

d 

0 diaeresis 

214 D6 

153 99 









6 

o acute 

243 F3 

162 A2 

X 

Multiplication sign 

215 D7 

158 9E 

6 

o circumflex 

244 F4 

147 93 

R 

R caron 

216 D8 

252 FC 

6 

o double acute 

245 F5 

139 8B 

o 

U 

U ring 

217 D9 

222 DE 

6 

o diaeresis 

246 F6 

148 94 

(j 

U acute 

218 DA 

233 E9 

+ 

Division sign 

247 F7 

246 F6 

u 

U double acute 

219 DB 

235 EB 

r 

r caron 

248 F8 

253 FD 

u 

U diaeresis 

220 DC 

154 9A 

O 

U 

u ring 

249 F9 

133 85 

Y 

Y acute 

221 DD 

237 ED 

U 

u acute 

250 FA 

163 A3 

T 

T cedilla 

222 DE 

221 DD 

U 

u double acute 

251 FB 

251 FB 

B 

German sharp s 

223 DF 

225 El 

ii 

u diaeresis 

252 FC 

129 81 

f 

r acute 

224 E0 

234 EA 

y 

y acute 

253 FD 

236 EC 

a 

a acute 

225 El 

160 A0 

t 

t cedilla 

254 FE 

238 EE 

a 

a circumflex 

226 E2 

131 83 


Dot above 

255 FF 

250 FA 

a 

a breve 

227 E3 

199 C7 





a 

a diaeresis 

228 E4 

132 84 





1 

1 acute 

229 E5 

146 92 





6 

c acute 

230 E6 

134 86 





e 

c cedilla 

231 E7 

135 87 
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Cyrillic Character Sets 


Table VIII-6 shows the characters of the ISO 8859-5 Latin/Cyrillic Alphabet (also known 
as ECMA-113), Microsoft Code Page 866, Old KOI-8, and the Short KOI equivalents that 
are used for displaying Russian words on ASCII devices by showing Cyrillic letters as 
lowercase ASCII and Roman letters as uppercase ASCII; for example, (IpoTOKon 
riepenann <t>ai/uioB Kermit is written protokol pereda-i f a j low kermit. 

The character names are taken from ISO Standard 8859-5, modified to show upper- or 
lowercase typographically rather than spelling out UPPERCASE and LOWERCASE for 
each letter. Unfortunately, the same name is used by ISO for two different characters: 
Cyrillic I (1) is the one that looks like a backwards Roman letter N, and Cyrillic I (2) looks 
like a Roman letter I. 

CP866 and the KOI character sets lack the Macedonian and Serbocroatian letters, as well 
as the old Cyrillic letters and one of the Ukrainian letters, that are found in ISO 8859-5. 
The CP866 characters BO through DF (hex) are identical to the line- and box-drawing 
characters of IBM CP437. The 8-bit ISO, KOI-8, and CP866 sets all include ASCII (ISO 
646 IRV) as their first 128 characters (except $ is replaced by o in KOI-8). 


Table VIII-6 Cyrillic Character Sets 

~ ISO CP866 KOI-8 Short 

Character Name Dec Hex Dec Hex Dec Hex KOI 


A 

Cyrillic A 

176 

BO 

128 

80 

225 

El 

a 

a 

Cyrillic a 

208 

DO 

160 

A0 

193 

Cl 

a 

5 

Cyrillic Be 

177 

B1 

129 

81 

226 

E2 

b 

6 

Cyrillic be 

209 

D1 

161 

A1 

194 

C2 

b 

B 

Cyrillic Ve 

178 

B2 

130 

82 

247 

F7 

w 

B 

Cyrillic ve 

210 

D2 

162 

A2 

215 

D7 

w 

r 

Cyrillic Ghe 

179 

B3 

131 

83 

231 

E7 

g 

r 

Cyrillic ghe 

211 

D3 

163 

A3 

199 

C7 

g 

fl 

Cyrillic De 

180 

B4 

132 

84 

228 

E4 

d 

A 

Cyrillic de 

212 

D4 

164 

A4 

196 

C4 

d 

E 

Cyrillic Ie 

181 

B5 

133 

85 

229 

E5 

e 

e 

Cyrillic ie 

213 

D5 

165 

A5 

197 

C5 

e 
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Table VIII-6 Cyrillic Character Sets (continued) 

ISO CP866 KOI-8 Short 

Character Name Dec Hex Dec Hex Dec Hex KOI 


E 

Cyrillic Io 

161 

A1 

240 

F0 



e 

e 

Cyrillic io 

241 

FI 

241 

FI 



e 

>K 

Cyrillic Zhe 

182 

B6 

134 

86 

246 

F6 

V 

X 

Cyrillic zhe 

214 

D6 

166 

A6 

214 

D6 

V 

3 

Cyrillic Ze 

183 

B7 

135 

87 

250 

FA 

z 

3 

Cyrillic ze 

215 

D7 

167 

A7 

218 

DA 

z 

n 

Cyrillic 1(1) 

184 

B8 

136 

88 

233 

E9 

i 

M 

Cyrillic i (1) 

216 

D8 

168 

A8 

201 

C9 

i 

v\ 

Cyrillic Short I 

185 

B9 

137 

89 

234 

EA 

j 

it 

Cyrillic Short i 

217 

D9 

169 

A9 

202 

CA 

j 

K 

Cyrillic Ka 

186 

BA 

138 

8A 

235 

EB 

k 

K 

Cyrillic ka 

218 

DA 

170 

AA 

203 

CB 

k 

n 

Cyrillic El 

187 

BB 

139 

8B 

236 

EC 

1 

n 

Cyrillic el 

219 

DB 

171 

AB 

204 

CC 

1 

M 

Cyrillic Em 

188 

BC 

140 

8C 

237 

ED 

m 

M 

Cyrillic em 

220 

DC 

172 

AC 

205 

CD 

m 

H 

Cyrillic En 

189 

BD 

141 

8D 

238 

EE 

n 

H 

Cyrillic en 

221 

DD 

173 

AD 

206 

CE 

n 

o 

Cyrillic O 

190 

BE 

142 

8E 

239 

EF 

0 

o 

Cyrillic o 

222 

DE 

174 

AE 

207 

CF 

o 

n 

Cyrillic Pe 

191 

BF 

143 

8F 

240 

F0 

P 

n 

Cyrillic pe 

223 

DF 

175 

AF 

208 

DO 

P 

P 

Cyrillic Er 

192 

CO 

144 

90 

242 

F2 

r 

P 

Cyrillic er 

224 

E0 

224 

E0 

210 

D2 

r 

C 

Cyrillic Es 

193 

Cl 

145 

91 

243 

F3 

s 

c 

Cyrillic es 

225 

El 

225 

El 

211 

D3 

s 

T 

Cyrillic Te 

194 

C2 

146 

92 

244 

F4 

t 

T 

Cyrillic te 

226 

E2 

226 

E2 

212 

D4 

t 

y 

Cyrillic U 

195 

C3 

147 

93 

245 

F5 

u 
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Table VIII-6 Cyrillic Character Sets (continued) 


ISO CP866 KOI-8 Short 


Character 

Name 

Dec Hex 

Dec Hex 

Dec Hex 

KOI 

y 

Cyrillic u 

227 E3 

227 E3 

213 D5 

y 

0 

Cyrillic Ef 

196 C4 

148 94 

230 E6 

f 

4> 

Cyrillic ef 

228 E4 

228 E4 

198 C6 

f 

X 

Cyrillic Ha 

197 C5 

149 95 

232 E8 

h 

X 

Cyrillic ha 

229 E5 

229 E5 

200 C8 

h 

u 

Cyrillic Tse 

198 C6 

150 96 

227 E3 

c 

u 

Cyrillic tse 

230 E6 

230 E6 

195 C3 

c 

H 

Cyrillic Che 

199 C7 

151 97 

254 FE 

~ 

H 

Cyrillic che 

231 E7 

231 E7 

222 DE 

- 

w 

Cyrillic Sha 

200 C8 

152 98 

251 FB 

{ 

LU 

Cyrillic sha 

232 E8 

232 E8 

219 DB 

{ 

W 

Cyrillic Shcha 

201 C9 

153 99 

253 FD 

} 

U4 

Cyrillic shcha 

233 E9 

233 E9 

221 DD 

) 

"b 

Cyrillic Hard Sign 

202 CA 

154 9A 



"b 

Cyrillic hard sign 

234 EA 

234 EA 

207 CF 


bl 

Cyrillic Yeri 

203 CB 

155 9B 

249 F9 

y 

bl 

Cyrillic yeri 

235 EB 

235 EB 

217 D9 

y 

b 

Cyrillic Soft Sign 

204 CC 

156 9C 

248 F8 

X 

b 

Cyrillic soft sign 

236 EC 

236 EC 

216 D8 

X 

3 

Cyrillic E 

205 CD 

157 9D 

252 FC 

1 

3 

Cyrillic e 

237 ED 

237 ED 

220 DC 

1 

fO 

Cyrillic Yu 

206 CE 

158 9E 

224 E0 

@ 

to 

Cyrillic yu 

238 EE 

238 EE 

192 CO 

@ 

51 

Cyrillic Ya 

207 CF 

159 9F 

241 FI 

q 

9 

Cyrillic ya 

239 EF 

239 EF 

209 D1 

q 

u 

Cyrillic Dze 

175 AF 




u 

Cyrillic dze 

255 FF 




1 

Cyrillic I (2) 

166 A6 




i 

Cyrillic i (2) 

246 F6 
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Table VIII-6 Cyrillic Character Sets (continued) 


ISO CP866 KOI-8 Short 

Character Name Dec Hex Dec Hex Dec Hex KOI 


J 

Cyrillic Je 

168 A8 

244 F4 

i 

Cyrillic je 

248 F8 

245 F5 

Jb 

Cyrillic Lje 

169 A9 


n= 

Cyrillic lje 

249 F9 


hb 

Cyrillic Nje 

170 AA 


hb 

Cyrillic nje 

250 FA 


y 

Bielorussian Short U 

174 AE 

246 F6 

y 

Bielorussian short u 

254 FE 

247 F7 

s 

Macedonian Dze 

165 A5 


s 

Macedonian dze 

245 F5 


r 

Macedonian Gje 

163 A3 


f 

Macedonian gje 

243 F3 


R 

Macedonian Kje 

172 AC 


k 

Macedonian kje 

252 FC 


t> 

Serbocroatian Dje 

162 A2 


*) 

Serbocroatian dje 

242 F2 


b 

Serbocroatian Chje 

171 AB 


k 

Serbocroatian chje 

251 FB 


€ 

Ukrainian Ie 

164 A4 

242 F2 

€ 

Ukrainian ie 

244 F4 

243 F3 

I 

Ukrainian Yi 

167 A7 


i 

Ukrainian yi 

247 F7 



No-break space 

160 AO 

255 FF 

N° 

Number Acronym 

240 F0 

252 FC 

§ 

Paragraph sign 

253 FD 



Soft hyphen 

173 AD 
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Appendix IX 

DOS/UNIX File Conversion 
Script 


This is a UNIX Bourne shell script to convert MS-DOS-format files and filenames to 
UNIX format. It assumes that the DOS-format files are in one directory and that another, 
empty, directory has been created for the converted files. Type this script in to a UNIX 
editor, save it as convert. sh, then make it executable using the command: 

$ chmod +x convert.sh 

Then run it, specifying the source and target directory names on the command line (with¬ 
out any terminating slash), for example: 

$ ./convert.sh /usr/me/doskermit /usr/me/kermit 

The convert procedure will keep you informed of its progress and will print the message 
Done. when it is finished. 

#1/bin/sh 

if [ $# -It 2 ]; then 

echo "usage: $0 source-directory target-directory" 
exit 1 
fi 

cd $1 

echo "Converting files from $1 to $2" 
for i in *; do 

j='echo $i | tr 'A-Z' 'a-z'' 
echo $l/$i =\> $2/$j 
tr -d '\015\032' < $i > $2/$j 
done 

echo Done. 
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Appendix X 


Hexification Programs 


The C programs hex. c and unhex. c translate between 8-bit binary files and straight 
hex files, in which every pair of hexadecimal digits corresponds to a single 8-bit byte. 


The hex. c program translates the standard input into hexadecimal notation and sends the 
result to standard output. Usage on UNIX or MS-DOS: 

hex < binaryfile > hexfile 

♦include <stdio.h> /* For EOF symbol */ 

#ifdef MSDOS 

♦include <fcntl.h> /* For MS-DOS 0 _binary symbol */ 

♦endif 


unsigned int c; 
char h[16] = { 
'0','1','2', '3 


int count = 0; char a, b; 


' D' , ' E' , ' F' } ; 


main() { 

♦ifdef MSDOS 

setmode(fileno(stdin),0_BINARY); 
♦endif 

while ((c = getchar()) 1= EOF) { 
b = c & OxF; 
a = (c » 4) & OxF; 
putchar(h[a]); 
putchar(h[b]); 
if (++count ==36) { 

putchar('\n'); count = 0; 

> 

} 

putchar('\n'); 

> 


/* Avoid DOS conversions */ 

/* For each file char */ 

/* Get low 4 bits */ 

/* and high 4 bits */ 

/* Hexify & output them */ 

/* 72 chars per line */ 


/* Terminate final line */ 
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The unhex program converts a hex file back into its original binary format. Usage on 

UNIX or MS-DOS: 

unhex < hexfile > binaryfile 

iinclude <stdio.h> /* Include this for EOF symbol */ 

#ifdef MSDOS 

iinclude <fcntl.h> /* For MS-DOS setmode() symbol */ 

iendif 

unsigned char a, b; /* High and low parts of byte */ 

unsigned int c; /* Char to translate them into */ 

unsigned char decode(); /* Function to decode them */ 

main() { 
iifdef MSDOS 

setmode(fileno(stdout),0_BINARY); /* Avoid DOS conversions */ 

iendif 

while ((c = getchar()) 1= EOF) { /* Read first hex digit */ 

a = c; /* Convert to character */ 

if (a == '\n' jj a == '\r') { /* Ignore line ends */ 

continue; 

> 

if ((c = getchar()) == EOF) { /* Read second hex digit */ 

fprintf(stderr,"File ends prematurely\n”); 
exit(1); 

} 

b = c; /* Convert to character */ 

putchar( ((decode(a) * 16) & OxFO) + (decode(b) & OxF) ); 

} 

exit(0); /* Done */ 

} 

/* Function to decode a hex char */ 
unsigned char 
decode(x) char x; { 

if (x >= '0' && x <= '9') /* 0-9 offset by hex 30 */ 

return (x - 0x30); 

else if (x >= 'A' && x <= 'F') /* A-F offset by hex 37 */ 

return(x - 0x37); 

else { /* All others illegal */ 

fprintf(stderr,"\nlnput is not in legal hex format\n”); 
exit(1); 

> 

} 
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Appendix XI 

Shift-In!Shift Out Filter 


Use this program, so.c, to display 8-bit text on your screen when your connection to the 
host is 7 bits. Usage examples: 

$ so < german.txt 
$ kermit -z | so~ 


#include <stdio.h> 

/* 

Standard i/o library */ 

main () { 

/* 

Main routine */ 

int x = 0, shift = 0; 
unsigned char c; 

/* 

Declarations */ 

while ((x = getchar()) 1= EOF) { 

/* 

Read a character */ 

c = x; 

/* 

Convert int to char */ 

if (c > 127) { 

/* 

8-bit character */ 

if (shift == 0) { 

/* 

Shifted already? */ 

putchar('\16'); 

/* 

No, output SO ( A N) */ 

shift = 1; 

> 

> else { 

/* 

Remember shift */ 

/* 

7-bit character */ 

if (shift == 1) { 

/* 

Shifted? */ 

putchar(' \17 ' ); 

/* 

Yes, output SI UO) */ 

shift =0; 

> 

/* 

Remember */ 

> 

putchar(c & 0x7F); 

} 

putchar('\17'); 

/* 

Output the character */ 

/* 

Return to normal */ 


> 
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Acronyms and Abbreviations 


3270 

A type of block-mode terminal used with IBM 370-series mainframes. 

ACK 

Acknowledgement. 

ACL 

Access Control List, a property of the VMS, OpenVMS, and AOS/VS file systems. 
ACS 

Asynchronous Communication Server. A device on a PC network that houses one or 
more serial ports that can be shared by all the PCs on the network. 

ACU 

Automatic Calling Unit. A modem that includes a dialer. 

Alt 

The key that you hold down while pressing another key in order to produce an Alt 
character, on keyboards that have an Alt (or Alternate) key. For example, Alt-X is 
produced by holding down Alt and pressing X. 

ANSI 

The American National Standards Institute, which issues standards such as ASCII. 
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AOS/VS 

Advanced Operating System / Virtual System, the operating system for Data General 
Eclipse MV-series computers. 

ARQ 

Automatic Repeat (or Retransmission) Request. Applies to a communications protocol 
in which retransmission of damaged messages can be requested. 

ASCII 

American Standard Code for Information Interchange, ANSI X3.4-1986. A 
128-character code widely used by computers for representing and transmitting charac¬ 
ter data, in which each character corresponds to a number between 0 and 127. See 
Table VIII-1. 

AXP 

The Digital Equipment Corporation 64-bit computer architecture, also called Alpha. 

BBS 

Bulletin board system. A dialup computer service that lets you exchange messages with 
other users of the same BBS, read news on various topics, and upload and download 
software and files. 

bps 

Bits per second (transmission speed). 

C 

The programming language used predominantly on UNIX systems, and in which 
C-Kermit is written. 

CO 

(C Zero) A set of 32 7-bit control characters. 

Cl 

(C One) A set of 32 8-bit control characters. 

CB 

Citizens Band. 

CCITT 

The International Telegraph and Telephone Consultative Committee of the International 
Telecommunications Union, which issues standards called Recommendations, such as 
CCITT Recommendations V.24, X.25 (q.v.). 

CD 

Carrier Detect. The signal from a modem that indicates it is connected to another 
modem. Also called Data Carrier Detect (DCD) and Receive Line Signal Indicator 
(RLSI). 
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cd 

Change Directory. The command used in UNIX, MS-DOS, OS/2, and several other 
operating systems to change your current (default) directory. 

CECP 

Country Extended Code Page. An EBCDIC-based national or international character set 
used on IBM mainframes. 

CK 

Filename prefix for C-Kermit files. 

CLI 

Command Line Interpreter (AOS/VS and Commodore Amiga). 

CP 

Code page, a character set used on PCs or IBM mainframes. 

CPS 

Characters per second, usually equivalent to 10 bits per second. 

CPU 

Central processing unit. The “brain” of a computer. 

CR 

Carriage return (ASCII 13, Control-M). 

CRC 

Cyclic redundancy check, an error-checking technique. 

CRLF 

Carriage return and linefeed, the sequence of ASCII characters (numbers 13 and 10) 
used by MS-DOS, OS/2, and other file systems to delimit lines in a text file. 

CRT 

Cathode ray tube. Commonly used to mean a video terminal, 
csh 

The C-Shell, the command interpreter supplied with Berkeley UNIX. 

CTERM 

The DECnet virtual terminal protocol used by the DECnet SET HOST command. 

Ctrl 

Control. The key that you hold down while pressing another key (a letter or certain 
others) in order to produce a control character. For example, Ctrl -C is produced by 
holding down Ctrl and pressing C. 
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CTS 

Clear To Send. The RS-232 signal that indicates the DCE’s readiness to accept data 
from the DTE. 

DCC 

Data Country Code (part of an X. 121 address). 

DCE 

Data Communications Equipment, such as a modem. 

DCL 

DIGITAL Command Language. A command interpreter as well as a language for writ¬ 
ing command procedures on Digital Equipment Corporation computers. 

DG 

Data General Corporation. 

DEC 

Digital Equipment Corporation. 

DMA 

Direct Memory Access. 

DNIC 

Data Network Identification Code (part of an X.121 address). 

DOS 

Disk Operating System. A computer operating system that uses a magnetic disk as its 
principal medium of permanent storage. Also, short for MS-DOS and PC-DOS. 

DSR 

Data Set Ready. A signal from a DCE to a DTE that says the DCE is turned on and in 
data mode. 

DTE 

Data Terminal Equipment, such as a computer or a terminal. 

DTR 

Data Terminal Ready. A signal from a DTE to a DCE that says the DTE is turned on 
and ready to communicate. 

EBCDIC 

Extended Binary Coded Decimal Interchange Code. The 8-bit character code used on 
IBM mainframes. Many variations exist, described in reference [35]. 

EIA 

The Electronic Industries Association, sponsor of RS-232. 
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EISA 

Extended Industry Standard Architecture, a 32-bit extension to the 16-bit ISA bus ar¬ 
chitecture used by the IBM PC/AT and compatibles. 

ESC 

Escape, ASCII character 27, Control-[. 

FAT 

File Allocation Table. The MS-DOS file system that is also supported by OS/2, in 
which file names are limited to 8.3 format (eight characters before the dot, three after). 

GO 

(G Zero) A set of 94 graphic characters, normally the graphic characters of ASCII (ISO 
646 International Reference Version). 

G1 

(G One) A set of 94 or 96 graphic characters. 

G2 

(G Two) A set of 94 or 96 graphic characters. 

G3 

(G Three) A set of 94 or 96 graphic characters. 

GL 

Graphics Left. The set of graphic characters selected by a 7-bit character whose encod¬ 
ing is in the range 33-126. 

GNU 

GNU is Not UNIX. An effort to develop, collect, and distribute free software, mostly 
for UNIX, by the Free Software Foundation. 

GOST 

The (former) USSR State Committee on Standards. 

GR 

Graphics Right. The set of graphic characters selected by an 8-bit character whose en¬ 
coding is in the range 160-255 (96-character sets) or 161-254 (94-character sets). 

GUI 

Graphical User Interface. 

HD 

High Density, such as the recording format of a diskette. 

HPFS 

The OS/2 High Performance File System, which supports long filenames. 
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IBM 

International Business Machines Corporation. 

I/O 

Input/Output. 

IP 

Internet Protocol. The routing protocol and addressing conventions used in the Internet. 

IRV 

International Reference Version (of ISO 646). 

ISA 

Industry Standard Architecture, referring to the 16-bit bus used by the IBM PC/AT and 
compatibles. 

ISO 

International Organization for Standardization. A voluntary international group of 
national standards organizations that issues standards in a number of areas, including 
computers, information processing, and character sets. 

ISO 646 

The ISO standard for country-specific 7-bit character sets. 

ISO 8859 

The ISO standard for international 8-bit character sets. 

JIS 

Japan Industrial Standard. 

JIS X 0201 

The Japanese standard single-byte code for Roman and Katakana characters. 

JIS X 0208 

The Japanese standard two-byte code for Kanji characters, including also Katakana, 
Roman, Cyrillic, Greek, and others. 

K 

Kilo, meaning either 1,000 or 1,024. 

KDD 

Kermit Dialing Directory. 

KOI 

(KOI/I) Russian abbreviation for Kog ana OSMeHa HHcj^opMaTcueii —Kod dlia Ob- 
miena Informatsiyey (Code for Information Interchange). 
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KSD 

Kermit Services Directory. 

ksh 

The K-Shell, or Korn shell [5]. An alternative command interpreter supplied with some 
versions of UNIX. 

LAN 

Local area network. 

LAPM 

Link Access Procedure for Modems, specified in CCITT V.42. 

LAT 

Local Area Transport protocol, used by DEC Ethernet terminal servers. 

LDM 

Limited Distance Modem. 

LZW 

Lempel, Ziv, Welch data compression. 

M 

Mega, meaning either one million or 1,048,576. 

MNP 

Microcom Networking Protocol, used by modems for error correction and data 
compression. Levels 1 through 4 provide error correction. Levels 5 and above also 
provide compression. 

MS-DOS 

Microsoft’s Disk Operating System for microcomputers based on the Intel 8086 CPU 
family. 

NAK 

Negative Acknowledgement. 

NFS 

Network File System. 

NRC 

National Replacement Character set. A 7-bit character set, usually, but not always, an 
ISO 646 national version. 

NTN 

Network Terminal Number (part of an X.121 address). 
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NUL 

ASCII character number 0, as distinct from the number zero or the ASCII character digit 
0 (ASCII 48). Also, the OS/2 and MS-DOS null device. 

OS 

Operating system. 

PAD 

Packet Assembler and Disassembler, the terminal interface to an X.25 network, 
specified in CCITT X.3. 

PBX 

Private Branch Exchange. A telephone system that serves the internal needs of an or¬ 
ganization and that provides connections to the external telephone network. Some 
PBX’s can be used for data as well as voice transmission within the organization. 

PC 

Personal computer. 

PDN 

Public data network, usually using X.25 protocols. 

PEP 

Telebit’s Packet Ensemble Protocol, used between Telebit modems. 

PM 

Presentation Manager. The OS/2 graphical user interface. 

PSN 

Packet switched network. 

REXX 

Procedures Language/2 for OS/2 and other operating systems. A batch-oriented lan¬ 
guage for writing system command procedures. 

RMS 

Record Management System. The file system interface for VMS, OpenVMS, and other 
DEC operating systems. 

ROM 

Read-Only Memory. 

RS-232 

An Electronic Industries Association (EIA) standard that gives the electrical and func¬ 
tional specification for serial binary digital data transmission. The most commonly used 
interface between DTEs and DCEs. The American equivalent of CCITT Recommen¬ 
dation V.24. 
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RTS 

Request To Send. A signal used by a DTE to regulate the flow of data from a DCE. 
When the DTE turns RTS on, the DCE is not supposed to send data. When the DTE 
turns RTS off, the DCE is allowed to send data. 

RTS/CTS 

A form of full-duplex flow control or half-duplex line access control that uses the RTS 
and CTS signals. Unlike Xon/Xoff, this is generally not an end-to-end mechanism; 
rather, it works between the PC and the device it is directly connected to, such as a high¬ 
speed modem. Also see RTS and CTS. 

sh 

The standard UNIX shell, also known as the Bourne shell. 

TCP 

Transmission Control Protocol. The transport layer of the TCP/IP protocol. 

TCP/IP 

A network protocol in widespread use for both local and wide area networking. The 
protocol of the worldwide Internet. 

TDD 

Telecommunication Devices for the Deaf. Usually a Teletype or other hardcopy ter¬ 
minal with a built-in modem, communicating at a very slow speed using a special 
modulation technique and a limited 5-bit character code called Baudot. 

TTY 

Teletype, an abbreviation commonly used to designate a terminal or a computer terminal 
port. 

UART 

Universal Asynchronous Receiver/Transmitter. An asynchronous communication port. 
UNIX 

A popular operating system originally developed at AT&T Bell Laboratories and noted 
for its portability. 

UUCP 

UNIX-to-UNIX Copy Program. 

V.22 

CCITT standard for 1200 bps full-duplex modems. 

V.22 bis 

CCITT standard for 2400 bps full-duplex modems. 
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V.23 

CCllT standard for 600 and 1200 bps half-duplex modems with 75 bps back channel 
(split-speed modems). 

V.24 

CCllT standard that gives the electrical and functional specification for serial binary 
digital data transmission; the European equivalent of RS-232. 

V.25 bis 

CCllT standard modem dialing language. 

V.32 

CCITT standard for 9600 bps modem connection. 

V.32 bis 

CCITT standard for 14400 bps modem connection. 

V.42 

CCITT standard error correction for modems, also called LAPM. 

\A2bis 

The CCITT data compression standard. 

VAX 

Virtual Address Extended. The Digital Equipment Corporation 32-bit computer 
architecture. 

VMS 

Virtual Memory System, the operating system for DEC VAX computers. Renamed to 
Open VMS in later releases for both VAX and AXP architectures. 

X.3 

The protocol specifying the interface between a terminal and an X.25 network, specified 
by CCITT Recommendation X.3, used on public data networks. 

X.25 

A networking method, specified by CCITT Recommendation X.25, used on public data 
networks. 

X.121 

An addressing method used on X.25 networks. 

Xon/Xoff 

The most common full-duplex flow control method, in which the receiver sends an Xoff 
character when its input buffer is close to filling up and an Xon when it has made room 
for more data to arrive. Also called software flow control, to distinguish it from 
hardware flow control methods such as RTS/CTS. 
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features, table of 168 

in local mode 104 

in remote mode 98 

incomplete 117 

initiating via escape sequence 266 
interruption of 109,147,444 
interruption of, in UNIX 393 
macros for 223 
network 103,105 
of binary files 113 
of text files 112 
recording information about 117 
resuming after interruption 116 
SEND command 96 
summaries of basic steps 5,118 
uploading with Kermit protocol 100 
uploading without Kermit protocol 202 
VMS labeled mode 412 
Filename, defined 27 
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Files 

binary versus text 112,113 
checking existence of 241 
menus of 19 
opening and closing 269 
reading and writing 270 
textual encoding of 207,477 
transferring 95,121,139,151 
translating 194 

Files, command. See Command files 
Filespec, defined 28 
FINISH command 141 
Finnish 

character set 180,463 
transliteration rules 192 
Flow control 46-48,124-126,362 
and Amiga C-Kermit 450 
and Atari ST C-Kermit 453 
and file transfer 124 
and half duplex connections 127 
and network connections 47,126 
and NeXT computers 40 
and OS/2 426,429 
and serial connections 46 
and UNIX 385 
hardware 40,47,48, 125, 386 
software 47,124, 126, 385 
FOR command 249 
FOREGROUND, IF condition 241 
Fortune computers 14 
FPS computers 14 
FPU computers 14 
French 

character set 180,184,463 
transliteration rules 192 
French-Canadian character set 463 
Full duplex 124,361 
Fullscreen file transfer display 106 
Functions 
built-in 252 
for arithmetic 257, 260 
for character string processing 253 
that call themselves 268 
user-defined 267 

GEMDOS 452 
Gender of connectors 371 
General Datacomm modems 52 
German 

character set 180,463 
text 185, 192 
transliteration rules 192 
GET command 142 
Global variables 224 
GOTO command 246 
Groups of files. See Wildcard 
GUI 387,401 


Half duplex 127,361 
Handshake 127 
HANGUP command 45, 69 
Hardware flow control. See Flow control, hardware 
Harris computers 14 
Hayes modem 52,54, 365 
commands, table of 365 
Help 

about a command 33 
within a command 18 
HELP command 33 
Hewlett Packard computers 14,41 
hex . c program 477 
Hexadecimal encoding of files 207,477 
Hidden files, UNIX 395 
Hiragana 189 
Home directory 

\v(home) variable for 56,230 
tilde notation for 395,454 
Honey DanBer UUCP 379 
Host names and addresses 69 
HST modems 52 
Hungarian character set 180,463 

IBM code page. See Code page 
IBM mainframes 14 
and file transfer 133 
fullscreen communication 135 
Kermit-370 capabilities 8 
linemode communication 133 
login scripts for 291 
IBM PS/2 AIX 14 
IBM PS/2 OS/2 420 
IBM RS/6000 14,41,88,184 
IBM RT PC 14 
Icelandic 

character set 463 
text 196 

transliteration rules 192 
ICL computers 14 
IF command 235-243 
IF COUNT command 248 
IF DEFINED command 228 
Incomplete file transfers 117 
INCREMENT command 259 
Initialization file, C-Kermit 35 
Amiga 35 

and character sets 197 
and dialing directory 56 
AOS/VS 35,444 
Atari ST 35,452 
customizing 36 
OS-9 35,456 
OS/2 35,421 
standard 36, 301 
UNIX 35,387 
VMS 35,404 
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INPUT buffer 280 
INPUT command 279 
Installation, C-Kermit 
Amiga 450 
AOS/VS 441 
OS/2 419 
UNIX 375 

Integrated Solutions computers 14 
Intel computers 14 

Interactive Systems Corporation UNIX 14 
International character sets. See Character sets 
Internet 9, 69 
Interruption 

of C-Kermit commands 22, 23, 389,402 
of file transfer 109, 147, 393,444 
of file transfer, table of keys 328 
IP address 69 

IRV (International Reference Version). See ISO 646 
ISO 646 character sets 

and escape sequences 176 
tables of 171,461,463 
ISO 8859-1 464 
ISO 8859-2 468 
ISO 8859-5 470 
ISO Latin Alphabet. See Latin 
Italian character set 180,463 

Japanese 

character sets 189 
Roman character set 463 
transfer character-set 183,190 
writing systems 189 
JIS (Japan Industrial Standard) 189 
Job control 389,392,394 
Jolix 14 

Kanji 189 

and AOS/VS 443 
Katakana 189 
Kermit 

overview xv, 1, 3 
Kermit News 

journal subscription 9 
Kermit protocol 95 
and 8-bit data 123 
and character sets 180 
and control characters 132 
negotiation of features 152 
packet types 107 
summary of 151 
Kermit software 

features, table of 8 
how to get it 9 
version list 10 
Key mapping 91 

and international characters 179 
and OS/2 C-Kermit 431 


and UNIX C-Kermit 392 
and VMS C-Kermit 404 
Keyboard 

OS/2 C-Kermit special keys 428 
Keypad mode 

escape sequences to change 440 
Keypad, numeric 
codes sent by 429 

controlling mode of via escape sequence 436 
setting mode of 432 
KOI-8 character set 180,187,470 

Label, GOTO 246 
Labeled file transfer, VMS 412-415 
Language-specific character-set translation 191 
Latin alphabet 

as file character-set 180,451 
as transfer character-set 183 
number 1, tables of 174,464 
number 2, table of 468 
structure of 172,459 
supported languages, table of 172 
Latin/Cyrillic Alphabet 470 
LGT comparison operator 239 
Linux/386 14 

LLT comparison operator 239 
Local computer 3, 37 
Local mode 

and server operation 150 
automation of 274 
file transfer 104 
Lock file, UUCP 378 
Locking shifts 

and file transfer 162,194 
and terminal connection 90, 178 
and the TRANSMIT command 204 
LOG DEBUG command 138 
Log files 

closing 138 
debug 138 
packets 138 
session, terminal 92 
transactions, file transfer 117 
LOG PACKETS command 138 
LOG SESSION command 92 
for capturing files 200 
LOG TRANSACTIONS command 117 
Logical names, VMS 

as environment variables 233 
Login scripts 276-296 

for commercial data services 294 
for IBM mainframes 291 
for UNIX 289 
for VMS 283 
how to write 276 
Long BREAK signal 85, 86 
Long packets 156 
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Long variable names 226 
Loopback connector 373 
Loops 

counted 248,249 
FOR 249 
WHILE 250 
Lotus 1-2-3 412 
LS command 32 
Luxor computers 14 

Macintosh AU/X 13 
Macintosh Kermit 8 
Macintosh Latin character set 464 
Macros 214-223 
arguments of 219 
as user-defined functions 267 
as variables with long names 226 
defining 214 
for dialing 275, 280 
for network connection 274 
invocation of 216 
sampler of 222 
using 216 

versus command files 218 
Mail, electronic. See Electronic mail 
MAIL command 147 
MAN command 33 
Masscomp computers 13 
Maximum function 257 
Menu. See Help 
Microcom modems 52,62 
Microport UNIX 14 
MINIX/386 14 
MIPS Computer Systems 14 
MNP 62,66,368,369 
Modcomp computers 14 
MODE, OS/2 command 420 
Modem eliminator 371 
Modem server 74 
Modem signals 363 
and dialing 45, 50 
and direct connections 49 
and OS/2 420 

and the SET CARRIER command 45 
debugging 373 
table of 364 
waiting for 283 
Modems 50-67,362-370 

and data compression 59, 62, 66, 370 
and error correction 59, 62,66, 368 
and hardware flow control 125 
and speed matching 60, 125 
and the DIAL command 54 
autodial 365 

Hayes, table of commands 365 
null 371 

selecting type of 51,317 


table of error-correction techniques 369 
table of modulation techniques 368 
table of types known to C-Kermit 52 
tone and pulse dialing 54 
with built-in Kermit protocol 62 
Modulation 362,367 
Motorola Delta Series computers 14 
Mouse 

and file transfer interruption 109 
and OS/2 C-Kermit 427 
MS-DOS Kermit 
and printing 266 
escape sequences 265 

TERMINALR and TERMINALS macros 266 
MSEND command 98,142 
MSKERMIT.INI file 266 
MSLEEP command 283 
Mt Xinu Mach 386 UNDC 14 
MV command 34 

NAK (negative acknowledgement) packet 151 
National character sets. See ISO 646 
NCR Tower computers 14 
Negotiation of Kermit features 152 
NET macro 274 
Network connections 67,68 
and Amiga C-Kermit 450 
and file transfer 103 
and flow control 126 
and OS/2 C-Kermit 426 
automated 274 
CONNECT-mode escapes 86 
establishing 67 
macros for 223 
NeXT computer 14 

and hardware flow control 40 
and key mapping 91 
and terminal emulation 88 
character set 180,184,464 
Kermit escape character 80 
Noise interference 

and file transfer 128,134 
Norsk Data computers 14 
Norwegian 

character set 180,463 
transliteration rules 192 
NOT, IF command modifier 235 
Null modem 48, 371 
Numbers, comparing 236 
NUMERIC, IF condition 240 

Okistation computers 14 
Olivetti computers 14 
ON_EXIT macro 218 
OPEN command 269 
Open VMS. See VMS 
OS-9 C-Kermit 1,454 
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OS/2 C-Kermit 1,419-440 

and serial communications 425 
and the mouse 427 
command procedures 424 
how to start 423 
installation 419 

terminal emulator escape sequences 435 
OSF/1 13 

OUTPUT command 278 

OVERWITE, file collision option 116 

Packet 

acknowledgement 151 
attribute 116, 165 
block check 128,136 
buffers 161 
format of 151 
handshake 127 
length 156 
log file 138 
padding characters 133 
retransmission 110,129 
start and end characters 132,136 
types, table of 108 
Packet log 270 
PAD. See X.25 
PAD command 75 
Padding characters 133 
Parity 

and 8th-bit-prefixing 123 
and file transfer 101, 122 
and OS/2 425 

and TELNET connections 123 
and terminal connection 88 
and X.25 connections 74 
automatic detection of 124 
explained 359 
how to change 123 
setting from dial directory 55 
PATH 

Amiga 450 
OS/2 424 

PAUSE command 33, 282 
PDP-11 13, 137 

Kermit-11 capabilities 8 
Penril modems 52 

PEP (Telebit Packet Ensemble Protocol) 369 

Performance. See Efficiency 

Perkin-Elmer computers 13 

PING command 73 

Pins, connector 371 

Portuguese character set 180,463 

POSIX 13 

Prefix 

8th-bit 123, 162 
control-character 132 
PRINT command 33 


Printing 

and OS/2 C-Kermit 431,437 
and server mode 146 
host controlled 437 
PC, transparent 266 
with C-Kermit’s PRINT command 33 
Problem solving 
dialing 57 
file transfer 121 
Program variable 231 
Programming commands 235-272 
structured 249 
Protection of files 97 
in UNIX 397 
Pseudoterminals 383 
PWD command 34 
Pyramid computers 14 

Question mark 

as command help request 18 
as wildcard character 96, 395,433 
QUIT command 17 
Quoting 

8-bit characters in Kermit packets 123 
control character in Kermit packets 132 
special characters in C-Kermit commands 21 

Racal Vadic modems 52 
READ command 270 
RECEIVE command 97 
Recording a terminal session 92 
Recursion 268 

Redirection of input and output 319 
in OS/2 C-Kermit 427 
in UNIX C-Kermit 388 
in VMS C-Kermit 402 
REINPUT command 280 
REMOTE CD command 144 
Remote computer 3,37 
REMOTE DELETE command 144 
REMOTE DIRECTORY command 145 
REMOTE HELP command 141 
REMOTE HOST command 146 
REMOTE KERMIT command 146 
REMOTE LOGIN command 146 
REMOTE LOGOUT command 146 
REMOTE PRINT command 146 
REMOTE SET command 147 
REMOTE SPACE command 145 
REMOTE TYPE command 145 
REMOTE WHO command 146 
RENAME, file collision option 116 
RENAME command 34 
Resuming an interrupted file transfer 116 
Retransmission of packets 129 
Return code. See Exit status 
RETURN command 267 
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Reverse slash. See Backslash 
Reverse video 439 
Ridge computers 14 
RM command 32 
Rollback. See Screen rollback 
Rolm 244PC 52,54 
RolmCBX 52,64 

RS-232, EIA Recommended Standard 360 
explained 363 
table of signals and pins 364 
RS/6000. See IBM 
RTS/CTS. See Flow control, hardware 
RUN command 33, 34 
Russian text 187,193 

Samsung computers 14 

SCO UNIX, Xenix, ODT 14,184, 378 

Screen 

clearing, escape sequences 437,440 
rollback in OS/2 C-Kermit 430 
special effects for 263 
SCRIPT command 307 
Script programming 273-309 
Scroll Lock key 429 
Security 

and UNIX C-Kermit 380 
of calling-card numbers 62 
of Kermit server 146 
of server mode 148 
SEND command 96,98, 142 
Sequent computers 14 
Serial communication explained 359-373 
Serial connections 42 
macros for 222 
Serial file transfer display 107 
SERIAL macro 274 
SERVER command 140 
Server mode 139-150 

access to host services 146 
and electronic mail 147 
and file transfer 142 
and local operation 150 
and printing 146 
and settings 147 
commands for 141 
entering 140 

file management services 144 
interruption of 147 
security of 148 
terminating 141 
Services directory file 297 
UNIX 387 
VMS 404 
Session log 92, 270 

SET BLOCK-CHECK command 128,136 
SET BUFFERS command 161 
SET CARRIER command 46 


SET CASE command 239,341 
SET COMMAND BYTESIZE command 88,174,178 
SET COUNT command 248 
SET DEBUG SESSION command 93 
and login scripts 285 
SET DEFAULT command 31 
SET DIAL DIAL-COMMAND command 61 
SET DIAL DIRECTORY command 55 
SET DIAL DISPLAY command 57 
SET DIAL HANGUP command 59 
SET DIAL INIT-STRING command 59 
SET DIAL KERMIT-SPOOF command 62 
SET DIAL MNP-ENABLE command 62 
SET DIAL MODEM-HANGUP command 59 
SET DIAL PREFIX command 61 
SET DIAL SPEED-MATCHING command 61 
SET DIAL TIMEOUT command 58, 62 
SET DUPLEX command 127 
SET ESCAPE command 80 
SET FILE CHARACTER-SET command 182 
and OS/2 434 

for Cyrillic character sets 188 
for J apanese character sets 190 
SET FILE COLLISION command 116 
SET FILE command, summaries 118,168 
SET FILE DISPLAY command 106 
SET FILE INCOMPLETE command 117 
SET FILE LABEL command 414 
SET FILE NAMES command 114 
SET FILE RECORD-LENGTH command 409 
SET FILE TYPE command 113 

and the TRANSMIT command 202 
in VMS 411,412,413 
SET FLOW command 126 
SET HANDSHAKE command 127 
SET HOST command 69 
SET INCOMPLETE command 117 
SET INPUT command 281,293 
SET INPUT ECHO command 281 
and escape sequences 289 
SET KEY command 91 

and international characters 179 
and OS/2 431 
and UNIX 392 

SET LANGUAGE command 191,195 
and the TRANSMIT command 196 
SET LINE command 43 
SET LOCAL-ECHO command 127 
SET MACRO command 216,347 
SET MODEM command 51 
SET NETWORK command 68 
SET PAD command 75,137 
SET PARITY command 
and file transfer 162 
and locking shifts 162, 178 
and terminal connection 88 
SET PROMPT command 17,105,229, 349 
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SET RECEIVE END-OF-PACKET command 132 
SET RECEIVE PACKET-LENGTH command 156 
SET RECEIVE PAD commands 133 
SET RECEIVE START-OF-PACKET command 132 
SET RECEIVE TIMEOUT command 130 
SET RETRY command 129 
SET SCRIPT ECHO command 308 
SET SEND END-OF-PACKET command 132 
SET SEND PACKET-LENGTH command 157 
SET SEND PAD commands 133 
SET SEND START-OF-PACKET command 132 
SET SEND TIMEOUT command 130 
SET SERVER command 144 
SET SESSION-LOG command 93 
and capturing files 200 
SET SPEED command 44 
SET SUSPEND command 389 
SET TAKE ECHO command 211 
SET TAKE ERROR command 211, 351 
SET TELNET command 72 
SET TERMINAL command 88-90 
ARROW-KEY mode 432 
BYTESIZE 88, 178 
CHARACTER-SET 89,175 
CHARACTER-SET, and OS/2 427,432 
CHARACTER-SET, and the TRANSMIT command 
203 

COLOR 432 
CR-DISPLAY 90 
CURSOR shape 432 
ECHO 90 

ECHO, and the TRANSMIT command 202 
KEYPAD mode 432 
LOCKING-SHIFT 90,179,427 
NEWLINE-MODE 90 
TYPE of terminal 432 
WRAP at screen margin 432 
SET TRANSFER CHARACTER-SET command 182 
and OS/2 434 
for Cyrillic text 187 
for Japanese text 190 
SET TRANSMIT command 203 
SET UNKNOWN-CHAR-SET command 185 
SET WILDCARD-EXPANSION command 394 
SET WINDOW command 159 
SET X.25 command 75 
SET XMIT command 203 
Setuid/setgid installation of UNIX C-Kermit 380 
Shift-in/shift-out. See Locking shifts 
Shift-JIS. See Japanese 
Short KOI character set 187, 194,470 
SHOW ARGUMENTS command 221 
SHOW ARRAYS command 227 
SHOW ATTRIBUTES command 167 
SHOW CHARACTER-SETS command 192 
SHOW COUNT command 355 
SHOW DEFAULT command 34 


SHOW DIAL command 57 
SHOW ESCAPE command 81 
SHOW FEATURES command 15,382 
SHOW FILE command 119 
SHOW FUNCTIONS command 253 
SHOW GLOBALS command 224 
SHOW KEY command 91 
and OS/2 431 

SHOW LANGUAGE command 192 
SHOW MACRO command 215 
SHOW MODEM command 356 
SHOW NETWORK command 68 
SHOW PAD command 356 
SHOW PROTOCOL command 168 
SHOW SERVER command 149 
SHOW STATUS command 240 
SHOW TERMINAL command 90 
SHOW TRANSMIT command 204 
SHOW VARIABLES command 232 
SHOW VERSION command 356 
Silicon Graphics computers 14 
Simplex 361 
Single shift 162 
Sliding windows 158 

Software flow control. See Flow control, software 
Solaris 13,14 
Solboume computers 14 
Sony computers 14 
Sorting 251 
SPACE command 34 
Spanish character set 180, 463 
Speaking devices 383 
Special screen effects 263 
Speed, communication 361 
and file transfer 103, 124, 131 
and modem speed matching feature 60 
and UNIX 383 
and VMS 400 
of SET LINE device 44 
setting from dial directory 55 
split 75/1200 44 
Speed-matching modems 60 
and file transfer 125 
Spoof, Kermit 62 
SprintNet 137,294 
Stardent computers 14 
Start and stop bits 360,361 
Start-of-packet character 132,136 
Starting C-Kermit 15 
in AOS/VS 443 
in OS-9 456 
in OS/2 423 
in UNIX 387 
in VMS 401 
on the Amiga 450 
on the Atari ST 453 
STATISTICS command 153 
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Stop bits 425 
STOP command 243 
String comparison 238 
case of letters in 239,279 
String functions 253 
SUCCESS, command status 240 
Sun computers 14,41,68,88 
SUSPEND command 389 
Suspending C-Kermit 389,392, 394 
Swedish 195 

character set 180,463 
text 195 

transliteration rules 192 
Swiss character set 180,463 

Tab character 

in command files 23 
in dialing directory 55 
in SCRIPT command 308 
in services directory 297 
used for command completion 20 
Tabs, terminal 437 

escape sequence to set 436 
using 435 

TAKE command 23, 210 
Tandy computers 14 
TCP/IP networks 67-74, 317 
and TELNET command 72 
ports and services 70 

TDD (Telecommunication Device for the Deaf) 383, 
400 

Tektronix computers 14 
Telebit modems 52,58 
and Kermit spoof 62 
TELNET command 72 
and echoing 72 

and SET TELNET command 72 
and terminal type 72 
CONNECT-mode escapes 86 
TELNET protocol 86, 89, 93 
Terminal 

and FULLSCREEN file transfer display 107 
device, UNIX 376 
modes, UNIX 390 
Terminal connection 79-93 
and character sets 175 
and key mapping 91 
and locking shifts 178 
debugging 93 
establishing 79 
hanging up 87 
logging 92 
returning from 80 
settings 88 
shell escape from 85 
status of 84 

TCP/IP TELNET 72,86 


Terminal emulation 88 
and Amiga C-Kermit 88 
and AOS/VS C-Kermit 445 
and Atari ST C-Kermit 88 
and OS/2 C-Kermit 426 
and UNIX C-Kermit 392 
and VMS C-Kermit 404 
and workstation console drivers 88 
Terminal servers 103,131 
and connection speed 383 
and flow control 385 
and VMS 400 
reverse 74 
Terminal type 

and Amiga C-Kermit 451 
and AOS/VS 442 
and Atari ST C-Kermit 453 
and OS-9 C-Kermit 456 
and OS/2 C-Kermit 432 
and speaking devices 383 
and TELNET connections 72 
and UNIX 382 
and VMS 399 

TERMINALR and TERMINALS macros 266 
Text files 143 

and OS/2 C-Kermit 434 
and the TRANSMIT command 203 
and word processors 112 
automatic recognition of in VMS 406 
definition of 112 
transfer of 112 
Thoroughbred BASIC 411 
Time-of-day variable, \v (ntime) 231 
Time-of-day variable, \v (time) 231 
Timeouts 

and DIAL command 58 
and file transfer 130 
and server command wait 144 
and SET LINE command 46 
and the INPUT command 279 
Tone dialing 54 
Trademarks, list of 497 
Trailing comments 23,215 
Transaction log 117,270 
Transfer character-set 183 
for Cyrillic text 187 
for Japanese text 190 
TRANSLATE command 194 
TRANSMIT command 202-207 
and character sets 196 
TRANSPARENT 

terminal character-set 175 
transfer character-set 183 
Transparent printing 266,437 
Tri Star computers 14 
Tty. See Terminal 
TYPE command 35 
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ULTRIX 13 

Undefined record format. VMS 411 
unhex . c program 478 
UNISYS computers 14 
UNIX 375-397 

and character sets 386 
and flow control 385 
and terminal speed 383 
control characters 384 
login script for 289 
terminal type 382 
versions supported by C-Kermit 13 
UNIX C-Kermit 375-397 
and UUCP lock files 43,377 
background operation of 388,394 
file transfer 393 
initialization file 387 
installation of 375 
interruption of 389, 393 
starting 387 
suspending 389,392 
terminal connection 392 
wildcard options 394 
Unknown character-set 185 
UPDATE, file collision option 116 
Uploading files 98 
US Robotics modems 52 
User-defined functions 267 
UUCP lock file 378 

V.22, CCITT Recommendation 66, 367 
V.22 bis, CCITT Recommendation 66, 367 
V.23, CCITT Recommendation 368 
V.24, CCITT Recommendation 360 
V.32, CCITT Recommendation 66, 367 
V.32Wr, CCITT Recommendation 66, 367 
V.42, CCITT Recommendation 369 
V.42Wr, CCITT Recommendation 369 
Vadic modems 52 
Variables 
array 227 
built-in 228 
defining 224,226,261 
displaying values of 224, 227, 232 
environment 233 
global 224 
macro arguments 219 
macros used as 226 
with long names 226 
VAX. See UNIX, VMS 
Ventel modems 52 
VERSION, IF condition 241 
VMS 399-417 

and character sets 401 
and terminal servers 400 
login script for 283 
wildcard characters 405 


VMS C-Kermit 399-417 

and DCL command procedures 403 

and file transfer 405 

and filename collisions 116 

and terminal connection 404 

and terminal speed 103 

and terminal type 399 

starting 401 

VT100 escape sequences. See Escape sequences 
VT52 escape sequences. See Escape sequences 

WAIT command 33,283 
WHILE command 250 
Wildcard characters 

and MSEND command 98 
and SEND command 96 
C-Kermit functions for 260 
in AOS/VS C-Kermit 446 
in OS/2 C-Kermit 433 
in UNIX C-Kermit 394 
in VMS C-Kermit 405 
quoting in C-Kermit 22, 395, 433 
Windows, sliding. See Sliding windows 
Word processor 
and text files 112 
macro for using 242 
using to create command files 23,210 
Wrap. See SET TERMINAL WRAP 
WRITE command 270 
WRITE SCREEN command 32 
WRITE SYSSOUTPUT command 32 

X.25 networks 68,74,318 
and file transfer 137 
Xenix 378 
XFER. See Transfer 
XIF command 249 
XLATE. See Translate 
XMIT. See TRANSMIT 
XON/XOFF. See Flow control, software 

ZIP files, VMS 412 
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C-Kermit Software Order Form 


January 1993 


TWO PRICES are shown for each item. The first price applies to the USA, Canada, and Mexico. 
The second price applies to all other countries. All prices are in US dollars. 


COMPLETE C-KERMIT DISTRIBUTION ON MAGNETIC TAPE 

Each tape includes all C-Kermit files: sources, installation files and instructions, help files, beware 
files, initialization files, plus selected binaries in UUENCODE, boo, or hex format: 


G 9-track 1600 BPI magnetic tape, ANSI format: $100 / $135 

Cl 9-track 1600 BPI magnetic tape, UNIX tar format: $ 100 / $ 135 

G 9-track 1600 BPI magnetic tape, DG DUMPFILE format: $150 / $185 

G Quarter-inch tape cartridge (QIC), UNIX tar format: $150 / $185 

G 8mm EXABYTE tape cartridge, UNIX tar format: $ 150 / $ 185 

□ TK50 cartridge, VMS / OpenVMS BACKUP format: $ 150 / $ 185 

Subtotal: $ 


SOURCE CODE ON DOS-FORMAT DISKETTES 

Source code, installation files, help and beware files for all C-Kermit versions: 
3.5" 5.25" 

720K 360K 

G G Source Code on DOS-Format Diskettes: $65 / $80 

Subtotal: $ 


BINARIES ON DOS-FORMAT DISKETTES 

Includes the binary executable C-Kermit program for the system indicated, plus all relevant instal¬ 
lation, initialization, demo, help, and beware files: 


3.5" 

5.25' 



720K 

360K 


o 

o 

C-Kermit for OS/2 2.00, 32-bit: 

$10/$15 

o 

o 

C-Kermit for OS/2 l.xx, 16-bit: 

$10/$15 

o 

o 

C-Kermit for OS-9/68000: 

$10 / $15 

o 

o 

C-Kermit for the Commodore Amiga: 

$10 / $15 

o 

G 

C-Kermit for the Atari ST: 

$10/$15 


Subtotal: $ 


ADDITIONAL KERMIT BOOKS 


G Using C-Kermit: $34.95 / $45 

G Using MS-DOS Kermit (includes Kermit diskette): $34.95 / $45 

G Kermit, A File Transfer Protocol : $29.95 / $35 

Subtotal: $ 


TOTAL SOFTWARE AND BOOKS: $ 


(Please turn over... ) 








C-Kermit Order Form 


PAYMENT 


January 1993 


Prepayment is required. Shipping by UPS or post is included in the price. Please do not add sales 
tax. You may pay by CREDIT CARD or by CHECK. Please complete ONE of the following three 
sections and mail this form, NOT A COPY, to the address shown on the bottom of the page. 


1. PAYMENT BY CREDIT CARD, ALL COUNTRIES 

□ MasterCard □ Visa AMOUNT OF PAYMENT: $ 

Card Number_ Expires 

Signature_ Date_ 


2. PAYMENT BY CHECK, USA ONLY Please enclose a check payable to: 

Columbia University Kermit Distribution 

TOTAL AMOUNT OF YOUR CHECK: $_ 

3. PAYMENT BY CHECK, ALL OTHER COUNTRIES 

Please enclose a check for the total amount payable in US dollars. PLEASE DO NOT USE 
ELECTRONIC BANK TRANSFERS OR INTERNATIONAL POSTAL COUPONS. Make your 
check payable to: 

Columbia University Kermit Distribution 
If your check is not drawn on a US bank, please add a $35 check-cashing fee: 

□ Check-cashing fee:_ TOTAL AMOUNT OF YOUR CHECK: $_ 


SHIP TO: 


Name: 

Phone: 

Organization: 

Address: 

Citv: 

State or Province: 

Country: 

Zip or Postal Code: 


MAIL YOUR COMPLETED ORDER FORM WITH PAYMENT TO 

Kermit Distribution, Department CKB 
Columbia University Academic Information Systems 
612 West 115th Street 
New York, NY 10025 USA 


Thank you! 






